NWC24AddDlTask

C Specification

#include <revolution/nwc24.h>
NWC24Err NWC24AddDlTask( NWC24DlTask* taskPublic );

Description

Adds a download task to the task list. An ID is assigned to a newly created task when it is added. Tasks which have already been added are overwritten in the same way as NWC24UpdateDlTask(), but the next scheduled download time will be reset.

There is a limit to how many tasks can be registered to the task list, and there cannot be more tasks than this maximum value, so the developer must always be careful with this. If there are no free entries when a task is registered, the oldest task (that is, the one that has not been called by NWC24AddDltask() or NWC24UpdateDlTask() in the longest time) will be automatically deleted.

Arguments

taskPublic Pointer to the download task.

Return Values

NWC24_OK: ended normally.
NWC24_ERR_BROKEN: the header of the download task is corrupt
NWC24_ERR_LIB_NOT_OPENED: the library has not been opened.
NWC24_ERR_PROTECTED: the download task is write-protected.
NWC24_ERR_INVALID_VALUE: the value of taskPublic is NULL, or the download task is invalid.
NWC24_ERR_FILE_*: internal file operation error.
NWC24_ERR_NOT_READY: WiiConnect24 has not been initialized.
NWC24_ERR_FATAL: a fatal error has occurred.

See Also

NWC24UpdateDlTask, NWC24DeleteDlTask

Revision History

2007/06/06 Added text about the maximum number of registered tasks.
2006/12/05 Initial version.


CONFIDENTIAL