NWC24GetDlTask

C Specification

#include <revolution/nwc24.h>

NWC24Err NWC24GetDlTask( NWC24DlTask* taskPublic, u16 id );

Description

Gets the download task with the specified ID.

When a task ID is stored somewhere and the task is obtained directly with NWC24GetDlTask(), check that the task was created by the same application using NWC24GetDlAppId. A task may be deleted and an identical ID may be assigned to a new task that is created by another application.

Arguments

`taskPublic`	Pointer to the location where the download task will be stored.
`id`	The download task ID.

Return Values

NWC24_OK: Acquired normally (the value is returned in *taskPublic).
NWC24_ERR_INVALID_VALUE: id is set to an invalid value.
NWC24_ERR_NOT_FOUND: The download task could not be found.
NWC24_ERR_FILE_*: Internal file operation error.

Revision History

2007/07/15 Added a cautionary note for when IDs are saved.
2006/12/05 Initial version.