NWC24ExecDownloadTask

C Specification

#include <revolution/nwc24.h>

NWC24Err NWC24ExecDownloadTask( u32 operationFlags, u16 taskId, u32 subTaskMask );

Description

Immediately executes download tasks that are registered with the task list.
Call this function when the library has not been opened. If an error occurs, a detailed error code can be obtained with NWC24GetErrorCode().

When the flags are zero, download processing is started in the same manner as the scheduler. In other words, the task that will be run is the task that should be executed next by the scheduler (among the tasks whose scheduled time for an update check has already passed, the one that has the highest priority).

Note: We do not recommend carrying out operations that accompany a firmware restart, such as OSShutdownSystem(), OSRestart(), and OSReturnToMenu(), while blocking due to an invocation of NWC24ExecDownloadTask(). If these operations are performed, debug carefully to avoid any problems.

Arguments

operationFlags

Operation flags

Name	Description
`NWC24_SCD_DL_FLAG_SPECIFY_ID`	Enables the value of the second argument, `taskId`.
`NWC24_SCD_DL_FLAG_SPECIFY_SUBID`	Enables the value of the third argument, `subTaskMask`. Will be used with future extensions. It will be ignored even if specified.)
`NWC24_SCD_DL_FLAG_REFRESH`	Download unconditionally, without checking to see whether the server contents have been updated.

taskId ID of the task to execute.

subTaskMask ID of the subtask to execute. Will be used with future extensions. It will be ignored even if specified.)

Return Values

NWC24_OK: Normal exit.
NWC24_ERR_LIB_NOT_OPENED: The library is not open.
NWC24_ERR_PROTECTED: The system settings do not permit use of WiiConnect24.
NWC24_ERR_NULL The contents of the task or the downloaded file are invalid
NWC24_ERR_INVALID_VALUE: The contents of the task or parameters are invalid.
NWC24_ERR_FILE_NOT_FOUNDCannot find file needed to execute the task (Download Box, key, and so on.)
NWC24_ERR_FILE_*: Error related to internal file operations.
NWC24_ERR_INTERNAL_VF: The VF library, which was called internally, returned an error.
NWC24_ERR_NAND_CORRUPT: NAND_RESULT_CORRUPT was generated internally.
NWC24_ERR_SERVER: A server error occurred.
NWC24_ERR_NETWORK: There was a problem with the network.
NWC24_ERR_CONFIG_NETWORK: The console network settings are inappropriate.
NWC24_ERR_VER_MISMATCH: Settings must be updated.
NWC24_ERR_FATAL: A fatal error has occurred.
NWC24_ERR_VERIFY_SIGNATURE: Signature verification failed.

Revision History

2007/09/26 Corrected omissions of error values
2007/07/25 Published manual as a public API.