SAVEGetStatOtherApplication / SAVEGetStatOtherApplicationAsync DEPRECATED

Syntax

#include <nn/save.h>

FSStatus            SAVEGetStatOtherApplication(
                        FSClient                *client,
                        FSCmdBlock              *block,
                        u64                     titleId,
                        u8                      accountSlotNo,
                        const char              *path,
                        FSStat                  *returnedStat,
                        FSRetFlag               errHandling
                        );
FSStatus            SAVEGetStatOtherApplicationAsync(
                        FSClient                *client,
                        FSCmdBlock              *block,
                        u64                     titleId,
                        u8                      accountSlotNo,
                        const char              *path,
                        FSStat                  *returnedStat,
                        FSRetFlag               errHandling,
                        const FSAsyncParams     *asyncParams
                        );

Parameters

client Pointer to the client buffer.
block Command block.
titleId The title ID of the target.
accountSlotNo The user account slot number.
path File path to get status. The relative path for the save directory for the specified user account. The length must be less than FS_MAX_ARGPATH_SIZE.
returnedStat Pointer to status information.
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 Successfully completed.
FS_STATUS_CANCELED The command was canceled.
FS_STATUS_NOT_FOUND Target not found.
or
The specified user account does not exist on this Wii U console.
FS_STATUS_PERMISSION_ERROR The caller does not have correct access permission.
FS_STATUS_MEDIA_NOT_READY (Only for manually mounted devices) Media is not present.
FS_STATUS_MEDIA_ERROR (Only for manually mounted devices) Media is in some inaccessible condition.
FS_STATUS_DATA_CORRUPTED (Only for manually mounted devices) The data is corrupted beyond repair. The volume needs format.
FS_STATUS_FATAL_ERROR The argument is invalid.

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

NOTE:

Gets the status information of the files or directories of other applications specified in titleId and path. This is identical to some directory entries (see FSReadDir).

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.

For the sync API, the status information obtained is stored in returnedStat when the process is completed.

If you plan to run an application that uses these functions in an environment with a USB drive connected, the USB drive must be connected when you start the application and create the save data. If you plan to run the application in an environment without a USB drive connected, the USB drive must be disconnected when you start the application and create the save data.

If you prepare save data using the Save Data Manager menu item in the System Config Tool, note that this function can only access save data that exists in NAND and USB storage, not on the host PC. Also note that to access save data in NAND, the application that uses these functions needs to be launched using either cafediscrun or caferun in an environment that is not connected to a USB drive.

Do Not Call From

SAVEGetStatOtherApplication

Deprecated Do not call this function in new code.

SAVEGetStatOtherApplicationAsync

Deprecated Do not call this function in new code.

See Also

File/Directory operations
FSStat
FSGetAsyncResult
SAVEGetFreeSpaceSize

Revision History

2014/10/22 Revised the return values.
2013/05/23 Deprecated function
2013/05/10 Added a description of how to create and access save data.
2013/05/08 Automated cleanup pass.
2013/03/27 added how to make save data for the access.
2012/10/01 Revised the return values.
2012/09/24 Initial version.


CONFIDENTIAL