nn::fs::MountExtSaveData Function

Syntax

Result MountExtSaveData(
const char * archiveName,
nn::fs::ExtSaveDataId id
);

Arguments

Name Description
in archiveName Specifies the archive name.
in id Specifies the ID of the expanded save data.

Return Values

Returns the result of the operation.
Value Description
Success. Process was successful. The return value's IsSuccess function returns true in this state.
ResultNotFound Expanded save data not found. Create it by calling the CreateExtSaveData function. Confirm that the ID value is correct during development.
ResultMediaNotFound An SD Card could not be found or recognized.
ResultArchiveInvalidated The SD Card may have been removed during the mount operation.
ResultWriteProtected The SD Card is write-protected.
ResultMediaAccessError An error occurred while accessing the SD Card due to some cause such as a loose connection.
ResultNotFormatted Failed during creation. Delete and then try calling CreateExtSaveData again.
ResultBadFormat Data region format invalid. Delete and then try calling CreateExtSaveData again. If this does not resolve the problem, you need to format the SD Card.
ResultVerificationFailed Either verification failed or some form of tampering was detected. Delete and then try calling CreateExtSaveData again.
A value other than the above. An application bug or some other unexpected error.

Description

Mounts expanded save data.

Mounts as an archive the expanded save data region having the specified ID.

Always check this function's return value to determine whether the expanded save data region is valid. If the expanded save data region is invalid, delete it using the DeleteExtSaveData function and then recreate it using the CreateExtSaveData function. Call this function again afterwards to mount it.

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

Revision History

2011/01/05
Revised the description of ResultMediaAccessError.
2010/12/15
Added a link to the error handling page.
2010/12/14
Added ResultMediaNotFound, ResultArchiveInvalidated, ResultWriteProtected, and ResultMediaAccessError to the return values.
2010/08/16
Initial version.

CONFIDENTIAL