1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6<TITLE>NWC24GetDlFilename</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<LINK rel="stylesheet" type="text/css" href="../nwc24.css">
9</HEAD>
10<BODY>
11<H1>NWC24GetDlFilename</H1>
12
13<H2>C Specification</H2>
14<DL>
15<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
16<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24GetDlFilename( const <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, char* <VAR>filename</VAR>, s32 <VAR>len</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Gets the save file name for a downloaded file.
22</P>
23
24<H2>Arguments</H2>
25<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
26  <TR>
27<TD class="name"><code><VAR>taskPublic</VAR></code></TD>
28    <TD class="description">
29Pointer to the download task.
30    </TD>
31  </TR>
32  <TR>
33<TD class="name"><code><VAR>filename</VAR></code></TD>
34    <TD class="description">
35Pointer to the location where the save file name is stored.
36    </TD>
37  </TR>
38  <TR>
39<TD class="name"><code><VAR>len</VAR></code></TD>
40    <TD class="description">
41Length of the storage buffer.
42    </TD>
43  </TR>
44</TABLE>
45
46<h2>Return Values</h2>
47<P>
48<code>NWC24_OK</code>: Obtained normally (A value is returned in *<code><VAR>filename</VAR></code>).<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library has not been opened.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: The value of either <code><VAR>taskPublic</VAR></code>  or <code><VAR>filename</VAR></code> is NULL, or the download task is invalid.<BR> <code>NWC24_ERR_NOT_FOUND</code>: The save file name is an empty string.<BR> <code>NWC24_ERR_NOMEM</code>: The string length of the save file name overflowed the buffer.<BR>
49</P>
50
51<H2>See Also</H2>
52<P>
53<A href="NWC24SetDlFilename.html"><CODE>NWC24SetDlFilename</CODE></A>, <!--     <A href="NWC24GetDlFilenameSubTask.html"><CODE>NWC24GetDlFilenameSubTask</CODE></A> -->
54</P>
55
56<H2>Revision History</H2>
57<P>
582006/12/05 Initial version.
59</P>
60
61<hr><p>CONFIDENTIAL</p></body>
62</HTML>