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>NWC24SetDlUrl</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>NWC24SetDlUrl</H1> 12 13<H2>Syntax</H2> 14<DL> 15 <DD><PRE><CODE>#include <revolution/nwc24.h></CODE></PRE> 16 <DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24SetDlUrl( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, const char* <VAR>url</VAR> );</CODE></PRE> 17</DL> 18 19<H2>Description</H2> 20<P> 21Sets the URL for the download task. The supported protocols are http and https. A maximum of 235 characters can be used for the configuration.<BR> 22</P> 23<P> 24If using http, you must enable the signature verification feature, and if using https, it must be signed by Nintendo's CA. When a download is actually under way, a string may be added to the URL depending on other parameters. 25</P> 26<P> 27It is also possible to explicitly specify the port number used in a URL by using the same URL notation as in a web browser.<BR> For example, specifying <CODE>http://foo:10080/bar</CODE> will connect to port 10080 on the host named <I>foo</I>. 28</P> 29 30<H2>Arguments</H2> 31<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument"> 32 <TR> 33 <TD class="name"><code><VAR>taskPublic</VAR></code></TD> 34 <TD class="description"> 35Pointer to the download task. 36 </TD> 37 </TR> 38 <TR> 39 <TD class="name"><code><VAR>url</VAR></code></TD> 40 <TD class="description"> 41The URL to specify. 42 </TD> 43 </TR> 44</TABLE> 45 46<h2>Return Values</h2> 47<P> 48<code>NWC24_OK</code>: Normal termination.<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library has not been opened.<BR> <code>NWC24_ERR_PROTECTED</code>: The download task cannot be written.<BR> <code>NWC24_ERR_NULL</code>: <code><VAR>url</VAR></code> is either NULL or a blank string. <BR> <code>NWC24_ERR_FULL</code>: The length of the <code><VAR>url</VAR></code> string has exceeded the limit.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: <code><VAR>taskPublic</VAR></code>'s value is either NULL or the download task is invalid.<BR> <code>NWC24_ERR_FORMAT</code>: The <code><VAR>url</VAR></code> does not start with either "http://" or "https://".<BR> 49</P> 50 51<H2>See Also</H2> 52<P> 53 <A href="NWC24GetDlUrl.html"><CODE>NWC24GetDlUrl</CODE></A> 54</P> 55 56<H2>Revision History</H2> 57<P> 582008/01/31 Added a note about the maximum URL length. <BR>2007/12/27 Commented that a port number can be specified in a URL. <BR>2006/12/05 Initial version.<BR> 59</P> 60 61<hr><p>CONFIDENTIAL</p></body> 62</HTML>