1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>NA_LoadOtherTitleArchive</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">NA_LoadOtherTitleArchive <IMG src="../../image/TWL.gif" width="23" height="12" border="0" align="middle"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19  <pre><CODE>#include &lt;twl/na.h&gt;
20
21<a href="../../fs/fs_result_const.html">FSResult</a> NA_LoadOtherTitleArchive( const char*    initialCode,
22                                   <a href="NATitleArchive.html">NATitleArchive</a> archive);
23</CODE></pre>
24</dd>
25</dl>
26
27<h2>Arguments</h2>
28<TABLE border="1" width="100%" class="arguments">
29  <TBODY>
30    <TR>
31<TH>initialCode</TH>
32<TD>Specifies the game code for the target NAND application as a 4-character ASCII string. It does not need to be null-terminated.</TD>
33    </TR>
34    <TR>
35<TH>archive</TH>
36<TD>Specifies the type of save data to load.</TD>
37    </TR>
38  </TBODY>
39</TABLE>
40
41<h2>Return Values</h2>
42<p>
43Returns <code>FS_RESULT_SUCCESS</code> if processing completed successfully. <br>Other values indicate an error. The following values, in particular, have specific meanings.
44</p>
45
46<table class="table">
47<tr><th>FS_RESULT_ALREADY_DONE<td>Save data has already been loaded from another NAND application.
48<tr><th>FS_RESULT_PERMISSION_DENIED<td>The NAND application has a different company code.
49<tr><th>FS_RESULT_UNSUPPORTED<td>This is running on the Nintendo DS and cannot be used.
50</table>
51
52
53<H2>Description</H2>
54<P>
55Loads the specified NAND application's save data region to the file system.
56</p>
57<P>
58You can only load save data from NAND applications with the same company code as this application. You cannot load save data from NAND applications with a different company code.
59</p>
60<P>
61If <span class="argument">archive</span> is <code>NA_TITLE_ARCHIVE_DATAPUB</code>, the save data is loaded as <CODE>otherPub</CODE> archive. If <span class="argument">archive</span> is <code>NA_TITLE_ARCHIVE_DATAPRV</code>, it is loaded as <CODE>otherPrv</CODE> archive.
62</p>
63<P>
64Only a single save data region from another NAND application can be loaded at once. To access more than one save data region, you must call the <code><a href="NA_UnloadOtherTitleArchive.html">NA_UnloadOtherTitleArchive</a></code> function to unload a save data region whenever one is accessed.
65</p>
66
67<h2>See Also</h2>
68<p><CODE><A href="NA_UnloadOtherTitleArchive.html">NA_UnloadOtherTitleArchive</A></CODE></p>
69
70<H2>Revision History</H2>
71<P>
722009/05/13 Added link to <B>See Also</B>.<br>
73 2008/09/16 Added <CODE>FS_RESULT_UNSUPPORTED</CODE> to the return values. <br>2008/07/14 Initial version.</P>
74<hr><p>CONFIDENTIAL</p></body>
75</html>
76