NWC24SetDlFilename

C Specification

#include <revolution/nwc24.h>
NWC24Err NWC24SetDlFilename( NWC24DlTask* taskPublic, const char* filename );

Description

Sets the file name when saving a downloaded file to VF. It is only valid when the type is NWC24_DLTYPE_OCTETSTREAM. All other values will return an error.

Arguments

taskPublic Pointer to the download task.
filename File name to set.

Return Values

NWC24_OK: Normal termination.
NWC24_ERR_LIB_NOT_OPENED: The library has not been opened.
NWC24_ERR_PROTECTED: The download task is write protected.
NWC24_ERR_NULL: filename is either NULL or an empty string.
NWC24_ERR_FULL: The length of the filename string has exceeded the limit
NWC24_ERR_INVALID_VALUE: taskPublic's value is either NULL or the download task is invalid.
NWC24_ERR_INVALID_OPERATION: The download task's type is not NWC24_DLTYPE_OCTETSTREAM.

See Also

NWC24GetDlFilename

Revision History

2006/12/05 Initial version.


CONFIDENTIAL