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_GetGHTTPDataEx2 function with the arguments set as follows: bufferlen=0, buffer_clear=TRUE, post=NULL, and progressCallback=NULL.

If the DWC_ProcessGHTTP function is called repeatedly after calling this function, the communication process will proceed and the completion callback will be called when the process completes.

To find the communication status during processing, 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_GetGHTTPDataEx2, DWC_ProcessGHTTP, DWCGHTTPCompletedCallback, DWC_GetGHTTPState

Revision History

2006/12/27 Made revisions in line with the addition of the DWC_GetGHTTPDataEx2 function
2006/01/18 Added DWC_GHTTP_IN_ERROR to return values
2005/10/27 Initial version


CONFIDENTIAL