#include <revolution/nwc24.h>NWC24Err NWC24SetDlUrl( NWC24DlTask* taskPublic, const char* url );
Sets the URL for the download task. The supported protocols are http and https. A maximum of 235 characters can be used for the configuration.
If 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.
It is also possible to explicitly specify the port number used in a URL by using the same URL notation as in a web browser.
For example, specifying http://foo:10080/bar will connect to port 10080 on the host named foo.
taskPublic |
Pointer to the download task. |
url |
The URL to specify. |
NWC24_OK: Normal termination.
NWC24_ERR_LIB_NOT_OPENED: The library has not been opened.
NWC24_ERR_PROTECTED: The download task cannot be written.
NWC24_ERR_NULL: url is either NULL or a blank string.
NWC24_ERR_FULL: The length of the url string has exceeded the limit.
NWC24_ERR_INVALID_VALUE: taskPublic's value is either NULL or the download task is invalid.
NWC24_ERR_FORMAT: The url does not start with either "http://" or "https://".
2008/01/31 Added a note about the maximum URL length.
2007/12/27 Commented that a port number can be specified in a URL.
2006/12/05 Initial version.
CONFIDENTIAL