SAVEChangeDir / SAVEChangeDirAsync

Syntax

#include <nn/save.h>

FSStatus            SAVEChangeDir(
                        FSClient                *client,
                        FSCmdBlock              *block,
                        u8                      accountSlotNo,
                        const char              *path,
                        FSRetFlag               errHandling
                        );
FSStatus            SAVEChangeDirAsync(
                        FSClient                *client,
                        FSCmdBlock              *block,
                        u8                      accountSlotNo,
                        const char              *path,
                        FSRetFlag               errHandling,
                        const FSAsyncParams     *asyncParams
                        );

Parameters

client Pointer to the client buffer.
block Command block.
accountSlotNo The user account slot number.
path Directory path to change the current directory. The relative path from the save directory for the specified user account. The length must be less than FS_MAX_ARGPATH_SIZE.
errHandling Automatic error handling flag. Only the indicated error is returned.
asyncParams (Async API only) Notification parameters for an asynchronous call.

Return Values

Synchronous API: Return Value; Asynchronous API: Callback Return Value

FS_STATUS_OK Successful.
FS_STATUS_NOT_FOUND The specified user account does not exist on this Wii U console.
FS_STATUS_CANCELED Command canceled.

Async API: Immediate Return Values

FS_STATUS_OK Successfully issued the request.
FS_STATUS_NOT_FOUND The specified user account does not exist on this Wii U console.
FS_STATUS_FATAL_ERROR The argument is invalid.

Description

Sets the current work save subdirectory to the directory specified in path. Note that the existence of specified directory is not checked, so you can specify a nonexistent directory.

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 FSAsyncParams.

Do Not Call From

SAVEChangeDir

None.

SAVEChangeDirAsync

None.

See Also

Path Space

Revision History

2014/10/22 Revised the return values.
2013/05/08 Automated cleanup pass.
2012/10/01 Revised the return values.
2012/03/29 Initial version.


CONFIDENTIAL