NWC24GetDlTaskByAppId

C Specification

#include <revolution/nwc24.h>
NWC24Err NWC24GetDlTaskByAppId( NWC24DlTask* taskPublic, u32 appId );
NWC24Err NWC24GetDlTaskByAppIdEx( NWC24DlTask* taskPublic, u32 appId, u32 param );

Description

Gets the download task registered by the application specified by appId.
If multiple tasks are registered, the function always gets the task with the most recent ID.

The target for NWC24GetDlTaskByAppIdEx can be narrowed to only those that match the value of the user parameter. This is useful when a single application is handling multiple tasks.

Arguments

taskPublic Pointer to the location where the download task will be stored.
appId Application ID.
param The value of the user parameter.

Return Values

NWC24_OK: Acquired normally (the value is returned in *taskPublic)
NWC24_ERR_INVALID_VALUE: The value of taskPublic is NULL, or appIdis 0.
NWC24_ERR_NOT_FOUND: The download task was not found.

See Also

NWC24GetDlTaskIdByAppId, NWC24GetDlTask, NWC24InitDlTask

Revision History

2007/08/29 Added NWC24GetDlTaskByAppIdEx.
2006/12/05 Initial version.

CONFIDENTIAL