#include <nn/save.h> FSStatus SAVEOpenFile( FSClient *client, FSCmdBlock *block, u8 accountSlotNo, const char *path, const char *mode, FSFileHandle *fileHandle, FSRetFlag errHandling ); FSStatus SAVEOpenFileAsync( FSClient *client, FSCmdBlock *block, u8 accountSlotNo, const char *path, const char *mode, FSFileHandle *fileHandle, FSRetFlag errHandling, const FSAsyncParams *asyncParams );
|client||Pointer to the client buffer.|
|accountSlotNo||The user account slot number.|
|path||Path that specifies the quota. The relative path for the save directory for the specified user account. The length must be less than
Short string parameter that specifies the access mode. The length must be less than
|fileHandle||Pointer to the handle of the file stream associated with the file to open.|
|errHandling||Automatic error handling flag. Only the indicated error is returned.|
|asyncParams||(Async API only) Notification parameters for an asynchronous call.|
||The command was canceled.|
||System has too many file points to create more.|
||The file is already open.
You are trying to open the file illegally.
||Target not found.
The specified user account does not exist on this Wii U console.
||Specified path is not a file.|
||Access mode is invalid (e.g. specified "r+" for read-only media).|
||The caller does not have correct access permission.|
||Journaling space is full and new journaling block cannot be allocated.|
||Data space cannot be allocated.|
||(Only for manually mounted devices) Media is not present.|
||(Only for manually mounted devices) Media is in some inaccessible condition.|
||(Only for manually mounted devices) The data is corrupted beyond repair. The volume needs format.|
||(Only for manually mounted devices) Media is write protected.|
||Successfully issued the request.|
||The specified user account does not exist on this Wii U console.|
||The argument is invalid.|
Opens the save data file specified in path, and creates the file stream associated with that file. The position of the file stream is set to the beginning. mode is a short string parameter to specify the access mode.
Both the sync and the async style API functions are provided. To use the async API functions, set the user callback and parameters in asyncParams.
For more information, see
The generated file handle is stored in fileHandle when completed.
The generated file handle is a positive value (>0) if the function succeeds. Otherwise, the handle value is
FS_INVALID_HANDLE_VALUE. The invalid handle value is not
necessary to close.
2014/10/22 Revised the return values.
FS_STATUS_JOURNAL_FULL to return values.
2013/05/08 Automated cleanup pass.
2012/10/01 Revised the return values.
2012/06/25 Fixed a link in the See Also list.
2012/06/14 Corrected links.
2012/03/29 Initial version.