DWC_NdGetFileListAsync

Syntax

#include <dwc.h>
BOOL DWC_NdGetFileListAsync(DWCNdFileInfo *filelist,
                            unsigned int offset,
                            unsigned int num);

Arguments

filelist Pointer to the array that stores the list of information retrieved.
offset Index of the first element in the list of retrieved information.
num Maximum number of items in the list of retrieved information.

Return Values

TRUE Success. The callback function called when the process of retrieving information has completed.
FALSE Failure. Use the DWC_GetLastErrorEx function to get error information.

Description

Starts getting the list of files that can currently be downloaded.

This function fails if communication with the download server is already in progress.
When the download process has completed, the callback function specified by DWC_NdInitAsync is called. The downloaded file information is stored in the array of DWCNdFileInfo structures specified by filelist.
Determination of downloadable files in the download server is based on the attribute string specified by the DWC_NdSetAttr function.

The library does not implement timeouts, so make sure that the application implements timeout processing or allows cancellation as necessary.

See Also

DWC_NdInitAsync
DWC_NdSetAttr
DWC_GetLastErrorEx
DWCNdFileInfo

Revision History

5.1 PR2
Added a description of the necessity of a timeout process.

For the changelog prior to 5.1 PR2, click here.


CONFIDENTIAL