1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>MountExtSaveData</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/fs/Overview.html">fs</a>::MountExtSaveData</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../nn/Result/Overview.html">Result</a> MountExtSaveData(
15     const char * archiveName,
16     <a href="../../nn/fs/ExtSaveDataId.html">nn::fs::ExtSaveDataId</a> id
17);
18</pre>
19    </div>
20<h2>Parameters</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>archiveName</th>
33<td>Specifies the archive name.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>id</th>
38<td>Specifies the ID of the expanded save data.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the result of the operation. <br />
43      <table class="arguments">
44        <thead>
45          <tr>
46<th>Value</th>
47<td>Description</td>
48          </tr>
49        </thead>
50        <tr>
51<th><CODE>Result::IsSuccess</CODE></th>
52<td>Process was successful.</td>
53        </tr>
54        <tr>
55<th><CODE>ResultNotFound</CODE></th>
56<td>Expanded save data not found. Create it by calling the <a href="../../nn/fs/CreateExtSaveData.html"><CODE>CreateExtSaveData</CODE></a> function. Confirm that the ID value is correct during development.</td>
57        </tr>
58        <tr>
59<th><CODE>ResultMediaNotFound</CODE></th>
60<td>An SD Card could not be found or recognized.</td>
61        </tr>
62        <tr>
63<th><CODE>ResultOperationDenied</CODE></th>
64<td>An operation was denied.<br />This error is returned only when recovery was performed internally.</td>
65        </tr>
66        <tr>
67<th><CODE>ResultWriteProtected</CODE></th>
68<td>The SD Card is write-protected.<BR>This error is returned only when recovery was performed internally.</td>
69        </tr>
70        <tr>
71<th><CODE>ResultMediaAccessError</CODE></th>
72<td>An error occurred while accessing the SD Card due to some cause such as a loose connection.</td>
73        </tr>
74        <tr>
75<th><CODE>ResultNotFormatted</CODE></th>
76<td>Failed during creation. Delete and then try calling <CODE><a href="../../nn/fs/CreateExtSaveData.html">CreateExtSaveData</a></CODE> again.</td>
77        </tr>
78        <tr>
79<th><CODE>ResultBadFormat</CODE></th>
80<td>Data region format invalid. Delete and then try calling <CODE><a href="../../nn/fs/CreateExtSaveData.html">CreateExtSaveData</a></CODE> again. If this does not resolve the problem, you need to format the SD Card.</td>
81        </tr>
82        <tr>
83<th><CODE>ResultVerificationFailed</CODE></th>
84<td>Either verification failed or some form of tampering was detected. Delete and then try calling <CODE><a href="../../nn/fs/CreateExtSaveData.html">CreateExtSaveData</a></CODE> again.</td>
85        </tr>
86        <tr>
87<th>A value other than the above.</th>
88<td>An application bug or some other unexpected error.</td>
89        </tr>
90      </table> </div>
91<h2>Description</h2>
92    <div class="section">
93<p>Mounts expanded save data.</p><p>Mounts as an archive the expanded save data region having the specified ID.</p><p>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 <a href="../../nn/fs/DeleteExtSaveData.html"><CODE>DeleteExtSaveData</CODE></a> function and then recreate it using the <a href="../../nn/fs/CreateExtSaveData.html"><CODE>CreateExtSaveData</CODE></a> function. Call this function again afterwards to mount it.</p><p>This function executes recovery internally if any discrepancy arises between metadata and actual data. <a href="../../nn/fs/ResultWriteProtected/Overview.html"><CODE>ResultWriteProtected</CODE></a> is returned as an error at this time if the SD Card has been write-protected. In addition, <a href="../../nn/fs/ResultOperationDenied/Overview.html"><CODE>ResultOperationDenied</CODE></a> is returned as an error if the read-only attribute has been set for the file or directory on the SD Card.</p><p>
94The following page has hints on how to handle mount errors. Please use this as a reference.
95</p><ul><li><a href="briefing/aboutErrorHandling.html#Mounting_ExtSaveDataArchive">Handling Mount Errors: Expanded Save Data Archives</a></li></ul></div>
96<h2>Revision History</h2>
97    <div class="section">
98      <dl class="history">
99        <dt>2011/01/05</dt>
100<dd>Deleted <CODE>ResultArchiveInvalidated</CODE> from the return values.<br />Revised the explanation for <CODE>ResultMediaAccessError</CODE>.<br />
101        </dd>
102        <dt>2010/12/15</dt>
103<dd>Added a link to the error handling page.
104        </dd>
105        <dt>2010/12/14</dt>
106<dd>Added <CODE>ResultMediaNotFound</CODE>, <CODE>ResultArchiveInvalidated</CODE>, <CODE>ResultWriteProtected</CODE>, and <CODE>ResultMediaAccessError</CODE> to the return values.
107        </dd>
108        <dt>2010/08/16</dt>
109<dd>Initial version.<br />
110        </dd>
111      </dl>
112    </div>
113  <hr><p>CONFIDENTIAL</p></body>
114</html>
115