nn::fs::MountExtSaveData Function

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

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

Returns the result of the operation.

Value	Description
Result::IsSuccess	Process was successful.
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.
ResultOperationDenied	An operation was denied. This error is returned only when recovery was performed internally.
ResultWriteProtected	The SD Card is write-protected. This error is returned only when recovery was performed internally.
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.

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.

This function executes recovery internally if any discrepancy arises between metadata and actual data. ResultWriteProtected is returned as an error at this time if the SD Card has been write-protected. In addition, ResultOperationDenied is returned as an error if the read-only attribute has been set for the file or directory on the SD Card.

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

• Handling Mount Errors: Expanded Save Data Archives

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.