1 /*---------------------------------------------------------------------------* 2 Project: Horizon 3 File: boss_NsData.h 4 5 Copyright (C)2009 Nintendo Co., Ltd. All rights reserved. 6 7 These coded instructions, statements, and computer programs contain 8 proprietary information of Nintendo of America Inc. and/or Nintendo 9 Company Ltd., and are protected by Federal copyright law. They may 10 not be disclosed to third parties or copied or duplicated in any form, 11 in whole or in part, without the prior written consent of Nintendo. 12 13 $Rev: 32212 $ 14 *---------------------------------------------------------------------------*/ 15 16 #ifndef NN_BOSS_BOSS_NSDATA_H_ 17 #define NN_BOSS_BOSS_NSDATA_H_ 18 19 #include <nn/fnd/fnd_DateTime.h> 20 #include <nn/boss/boss_Const.h> 21 #include <nn/boss/boss_Result.h> 22 #include <nn/boss/boss_Types.h> 23 24 #ifdef __cplusplus 25 26 namespace nn { 27 namespace boss { 28 29 /*! 30 @brief NSデータを表すクラスです。NSデータの操作(Readなど)に利用します。 31 */ 32 class NsData 33 { 34 public: 35 static const s32 NN_BOSS_NSDATA_READ_ERROR_GET_HEADER = -1; //!< NSデータのReadNsDataエラー定義。NSデータヘッダの取得に失敗した。 36 static const s32 NN_BOSS_NSDATA_READ_ERROR_READ_DATA = -2; //!< NSデータのReadNsDataエラー定義。NSデータの読み込みに失敗した。 37 static const s32 NN_BOSS_NSDATA_READ_ERROR_IPC = -3; //!< NSデータのReadNsDataエラー定義。IPCでエラーが発生した。 38 static const s32 NN_BOSS_NSDATA_READ_ERROR_UPDATED = -4; //!< NSデータのReadNsDataエラー定義。前回のデータ取得時以降に、対象NSDのバージョンがが更新された。 39 NN_PADDING4; 40 41 /*! 42 @brief コンストラクタです。 43 */ 44 explicit NsData(void); 45 46 /*! 47 @brief デストラクタです。 48 */ 49 virtual ~NsData(void); 50 51 /*! 52 @brief シリアルIDを指定してNSデータを初期化します。(一度使用したインスタンスであっても、本関数を実行することで再度使用可能となります。) 53 @param[in] serial シリアルIDを指定します。 54 @return 関数の実行結果を返します。以下に挙げる Result を返します。 55 @retval ResultSuccess 初期化に成功しました。 56 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 57 */ 58 nn::Result Initialize(u32 serial); 59 60 /*! 61 @brief NSDを削除します。他のアプリがすでに削除したり、NSAダウンロード時に領域が足らなくなり、 62 自動削除された場合など、対象のNSデータが見つからない場合がありますので、ご注意ください。 63 @return 関数の実行結果を返します。以下に挙げる Result を返します。 64 @retval ResultSuccess 削除に成功しました。 65 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 66 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 67 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 68 */ 69 nn::Result Delete(void); 70 71 /*! 72 @brief NSAヘッダ情報を読込みます。 73 下記のNSAヘッダ情報の種類を指定すると、相当する値が取得できます。 74 このとき、必要な領域が確保しておく必要があります。必要な領域のバイト以下であると @ref ResultInvalidNsDataGetHeadSize エラーが返ります。 75 NSD_TITLEID 64ビットのタイトルIDです。(s64) 76 NSD_FLAGS NSDのフラグです。 (bit32) 77 NSD_DATATYPE NSDのデータタイプです。 (bit32) 78 NSD_LENGTH NSDの長さです。 (s32) 79 NSD_SERIALID NSDのシリアルIDです。 (u32) 80 NSD_VERSION NSDのバージョン番号です。 (u32) 81 他のアプリがすでに削除したり、NSAダウンロード時に領域が足らなくなり、 82 自動削除された場合など、対象のNSデータが見つからない場合がありますので、ご注意ください。 83 @param[in] type ヘッダの要素種別を指定します。 84 @param[out] pValue ヘッダ情報の格納バッファを指定します。 85 @param[in] size バッファサイズを指定します。 86 @return 関数の実行結果を返します。以下に挙げる Result を返します。 87 @retval ResultSuccess 読込みに成功しました。 88 @retval ResultInvalidNsDataValue NSDATA格納領域のポインタがNULLです。 89 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 90 @retval ResultInvalidNsDataGetHeadSize GetHeaderInfo関数で指定したヘッダタイプに対応するサイズが一致しません。通常発生することはありませんが、何らかの異常が発生した可能性があります。 91 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 92 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 93 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 94 */ 95 nn::Result GetHeaderInfo(HeaderInfoType type, void* pValue, size_t size); 96 97 /*! 98 @brief NSDを読込みます。ファイルアクセスに似たインタフェースとなっています。 99 あらかじめ、適当なサイズのバッファを用意した後、繰り返し呼び出すことのより、NSデータ全体を読み込むことができます。 100 終端に達したときは 0 が返りますので、終了判定が可能です。 101 アプリは、一時点で1つのNSデータしか読み込めませんが、大きなNSDを読み込んでいても、同じNSデータをアクセスしない限り、 102 他のアプリのNSデータの読み込みをブロックしません。 103 他のアプリがすでに削除したり、NSAダウンロード時に領域が足らなくなり、 104 自動削除された場合など、対象のNSデータが見つからない場合は、エラーが返りますので、ご注意ください。 105 また、稀に前回のデータ取得時以降に、対象NSDのバージョンが更新された場合、NN_BOSS_NSDATA_READ_ERROR_UPDATED が返ります。 106 この場合の対処方法は、@ref Initialize を呼び出した後、読み直しを行ってください。 107 @param[out] pDataBuf NSデータのバッファを指定します。 108 @param[in] bufLen NSデータのバッファ長を指定します。 109 @return 読み込んだバイト数を返します。終端に達したときは 0 を返します。 110 @retval NN_BOSS_NSDATA_READ_ERROR_GET_HEADER NSデータヘッダの取得に失敗しました。 111 @retval NN_BOSS_NSDATA_READ_ERROR_READ_DATA NSデータの読み込みに失敗しました。 112 @retval NN_BOSS_NSDATA_READ_ERROR_IPC 内部エラーが発生しました。 113 @retval NN_BOSS_NSDATA_READ_ERROR_UPDATED 前回のデータ取得時以降に、対象NSDのバージョンが更新されました。 114 */ 115 s32 ReadData(u8* pDataBuf, size_t bufLen); 116 117 /*! 118 @brief NSDの読み込み位置を変更します。ファイルアクセスに似たインタフェースとなっています。 119 読み込み位置の変更する基準は、@ref PositionBase を参照ください。 120 @param[in] position 読み込み位置の変更する位置を指定します。 121 @param[in] base 読み込み位置の変更する基準を指定します。 122 @return 関数の実行結果を返します。以下に挙げる Result を返します。 123 @retval ResultSuccess 読み込み位置を変更に成功しました。 124 @retval ResultInvalidNsDataSeekPosition NSデータのシーク位置がデータサイズを超えています。 125 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 126 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 127 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 128 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 129 */ 130 nn::Result SetReadDataPosition(s64 position, PositionBase base); 131 132 /*! 133 @brief NSデータの付加情報を設定します。NSデータの付加情報は、アプリが自由に使用できる情報ですが、 134 この付加情報は、新しいバージョンのNSデータのダウンロードがされると初期化されますので、ご注意ください。 135 @param[in] info 設定する付加情報を指定します。 136 @return 関数の実行結果を返します。以下に挙げる Result を返します。 137 @retval ResultSuccess 設定に成功しました。 138 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 139 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 140 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 141 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 142 */ 143 nn::Result SetAdditionalInfo(u32 info); 144 145 /*! 146 @brief NSデータの付加情報を取得します。NSデータの付加情報は、アプリが自由に使用できる情報ですが、 147 この付加情報は、新しいバージョンのNSデータのダウンロードがされると初期化されますので、ご注意ください。 148 @param[in] info 現在の付加情報が返ります。 149 @return 関数の実行結果を返します。以下に挙げる Result を返します。 150 @retval ResultSuccess 取得に成功しました。 151 @retval ResultInvalidNsDataInfo NSデータ追加情報を格納するポインタがNULLです。 152 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 153 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 154 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 155 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 156 */ 157 nn::Result GetAdditionalInfo(u32* pInfo); 158 159 /*! 160 @brief NSデータの既読フラグを設定します。アプリの判断で既読に設定できますが、 161 新しいバージョンのNSデータのダウンロードがされると未読に戻りますので、ご注意ください。 162 @param[in] flag 取得するフラグを指定します。 既読の場合、trueが返ります。 163 @return 関数の実行結果を返します。以下に挙げる Result を返します。 164 @retval ResultSuccess 設定に成功しました。 165 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 166 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 167 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 168 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 169 */ 170 nn::Result SetReadFlag(bool flag); 171 172 /*! 173 @brief NSデータの既読フラグを取得します。 174 @param[out] flag 取得したフラグが返ります。既読の場合、trueが返ります。 175 @return 関数の実行結果を返します。以下に挙げる Result を返します。 176 @retval ResultSuccess 取得に成功しました。 177 @retval ResultInvalidNsDataReadFlag NSデータリードフラグの格納領域のポインタがNULLです。 178 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 179 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 180 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 181 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 182 */ 183 nn::Result GetReadFlag(bool* pFlag); 184 185 /*! 186 @brief NSDの更新日時を取得します。 187 更新日時とは、実際にダウンロードした日時ですのでご注意ください。 188 @param[out] pTime 更新したタイムスタンプが返ります。 189 @return 関数の実行結果を返します。以下に挙げる Result を返します。 190 @retval ResultSuccess 取得に成功しました。 191 @retval ResultInvalidNsDataTime NSデータのUPDATEタイムの格納領域のポインタがNULLです。 192 @retval ResultNsDataNotFound 指定されたNSデータが見つかりません。自動削除によって削除された可能性があります。 193 @retval ResultStorageAccessPermission ストレージのアクセス権がありません。拡張セーブ領域へのアクセスできません、アクセス権があるかどうか再確認をしてください。 194 @retval ResultIpcNotSessionInitialized セッションが初期化されていないか、権限不適合です。@ref Initialize もしくは @ref InitailizePriviledged の呼び出し前に本関数が呼び出されると、このResultが返ります。BOSSライブラリを利用する際には、必ず初めに@ref Initialize もしくは @ref InitailizePriviledged を呼び出してください。 195 @retval 上記以外 想定外のエラー(エラー内容については、@ref boss_Result.h を参照)。 196 */ 197 nn::Result GetLastUpdated(nn::fnd::DateTime* pTime); 198 199 protected: 200 bool m_Privileged; 201 NN_PADDING3; 202 u32 m_SerialId; 203 s32 m_dataSize; 204 u32 m_DataVersion; 205 AppIdType m_AppId; 206 s64 m_ReadDataPos; 207 }; 208 209 210 } // end of namespace boss 211 } // end of namespace nn 212 213 #endif // __cplusplus 214 215 #endif /* NN_BOSS_BOSS_NSDATA_H_ */ 216