DWC_GetGHTTPData

C Specification

#include <dwc.h>

int DWC_GetGHTTPData(
                     const char* url,
                     DWCGHTTPCompletedCallback completedCallback, 
                     void* param );

Description

Downloads data from the URL specified with url.

This function behaves the same as the DWC_GetGHTTPDataEx function with the arguments bufferlen=0, buffer_clear=TRUE, and progressCallback=NULL specified.

If the DWC_ProcessGHTTP function is called continuously after calling this function, the download process proceeds, and once the download process is complete, a completion callback is called.

To find the communication status when downloading, call the DWC_GetGHTTPState function using the request identifier of the return value.

Arguments

url URL of download destination
completedCallback The pointer to the callback function called when the download is complete.
param Callback parameter.

Return Values

0 or higher Request identifier.
DWC_GHTTP_IN_ERROR An error is being generated.
DWC_GHTTP_FAILED_TO_OPEN_FILE File open failed.
DWC_GHTTP_INVALID_POST Invalid transmission.
DWC_GHTTP_INSUFFICIENT_MEMORY Insufficient memory.
DWC_GHTTP_INVALID_FILE_NAME Invalid file name.
DWC_GHTTP_INVALID_BUFFER_SIZE Invalid buffer size.
DWC_GHTTP_INVALID_URL Invalid URL.
DWC_GHTTP_UNSPECIFIED_ERROR Unspecified error.

See Also

DWC_GetGHTTPDataEx, DWC_GetGHTTPState, DWC_ProcessGHTTP, DWCGHTTPCompletedCallback

Revision History

01/18/2006 Added DWC_GHTTP_IN_ERROR to the return values.
10/27/2005 Initial version.