NWC24GetDlError

C Specification

#include <revolution/nwc24.h>

NWC24Err NWC24GetDlError( const NWC24DlTask* taskPublic, s32* code, s32* count );

Description

Obtains the most recently generated error code and error generation count from a download task's error history information. The error information is cleared when the task is updated. Get it before updating the task.

Arguments

`taskPublic`	Pointer to the download task.
`code`	Pointer to where the most-recently generated error code is stored. The error codes are the same as those obtained with `NWC24GetErrorCode()`, but limited to those errors related to server connections. Errors related to network startup, 5XXXXX, can not be obtained.
`count`	Storage pointer for the error generation count. Since the count includes retries on failure, this value may become larger than the maximum value expected from the elapsed time and update check interval.

Return Values

NWC24_OK: Obtained normally (A value is returned in *code and *count).
NWC24_ERR_LIB_NOT_OPENED: The library has not been opened.
NWC24_ERR_INVALID_VALUE: The value of either taskPublic, code, or count is NULL, or else the download task is invalid.

Revision History

2007/07/25 Initial version.