NA_FormatTitleArchive 

構文

#include <twl/na.h>

FSResult NA_FormatTitleArchive(NATitleArchive archive);

引数

archive 初期化するセーブデータ領域を指定します。

返り値

正しく処理が完了した場合は FS_RESULT_SUCCESS が返ります。
そのほかの値はエラーです。 特に以下の値は固有の意味を持ちます。

FS_RESULT_UNSUPPORTEDニンテンドー DS 上で動作しているため使用できません。

説明

指定したセーブデータ領域を初期化します。
初期化できるのは自身のセーブデータ領域のみです。 他のアプリのセーブデータ領域は初期化できません。

セーブデータ領域の初期化を行うと、 セーブデータ領域内の全てのディレクトリおよびファイルが削除されます。 また FS ライブラリの関数で FS_RESULT_BAD_FORMAT が返ってくるような 状況を回復します。

この関数は初期化するセーブデータ領域の大きさに比例して処理に時間がかかります。 おおよそ 1 MB につき 10 秒の時間がかかりますので、 ガイドラインに従い適切な表示を行ってください。 なお、この関数は同期関数であるため、処理が完了するまで制御を返さないことにご注意ください。

参照

履歴

2008/11/26 同期関数であることを明記。
2008/09/26 初版