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.
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
Deleted ResultArchiveInvalidated from the return values.
Revised the explanation for 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