nn::fs::MountSaveData Function

Syntax

Result MountSaveData(
     const char * archiveName,
     bit32 uniqueId
);

Arguments

Name Description
in archiveName Specifies the archive name.
in uniqueId Specifies the unique ID for the other application.

Return Values

Returns the result of the operation.
Value Description
Result::IsSuccess Process was successful.
ResultAlreadyExists The specified archive name is already mounted.
You must not allow this error to occur in retail products.
ResultOperationDenied Operation denied because the save data are currently being mounted.
You must not allow this error to occur in retail products.
ResultNotFormatted Not formatted. The other application's format is prohibited, so that application itself needs to do the formatting.
ResultBadFormat Invalid format. The other application's format is prohibited, so that application itself needs to do the formatting.
ResultVerificationFailed Either verification failed or some form of tampering was detected. The other application's format is prohibited, so that application itself needs to do the formatting.
A value other than the above An application bug or some other unexpected error.

Description

Mounts the save data archive that is in another application.

The save data region of another application is mounted as a save data archive. The other application is specified by specifying its unique ID.

There is no ironclad guarantee that the save data this function is supposed to mount actually exists. For this reason, you need to prepare adequate error handling.

There are restrictions on the unique IDs that this function can specify, so for proper access you need to make the necessary descriptions in the RSF files of the programs that call this function. For details, see the ctr_makerom reference.

The following page has hints on how to handle mount errors. Please use this as a reference.

Revision History

2012/04/26
Separated the demo-version functions.
2012/02/16
Deleted text about double mounting.
Added overloaded version for mounting save data from other applications.
2011/04/15
Added text about double mounting.
2011/04/13
Added ResultOperationDenied to the Return Values.
2010/12/15
Added a link to the error handling page.
2010/08/16
Initial version.

CONFIDENTIAL