NWC24GetDlTaskIdByAppId

C Specification

#include <revolution/nwc24.h>
NWC24Err NWC24GetDlTaskIdByAppId( u16* id, u32 appId );>
NWC24Err NWC24GetDlTaskIdByAppIdEx( u16* id, u32 appId, u32 param );

Description

Gets the ID of 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 NWC24GetDlTaskIdByAppIdEx 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

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

Return Values

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

See Also

NWC24GetDlTaskByAppId

Revision History

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


CONFIDENTIAL