#include <dwc.h>
int DWC_GetGHTTPDataEx2(
const char* url,
int bufferlen,
BOOL buffer_clear,
DWCGHTTPPost *post,
DWCGHTTPProgressCallback progressCallback,
DWCGHTTPCompletedCallback completedCallback,
void* param );
Uploads/Downloads data from the URL specified with url.
In post, specify a DWCGHTTPPost type object created by the DWC_GHTTPNewPost function for the data to be uploaded
Allocates memory inside the library of a size specified by bufferlen. Specifying 0 allocates 2048 bytes of memory first, then allocates additional 2048 bytes chunks as needed based on the reception data size. This enables data reception up to the application-allocated heap region limit.
When buffer_clear is set to TRUE, the reception buffer is deallocated immediately after exiting the completion callback. Be sure to copy the reception data before using it. When buffer_clear is set to FALSE, the GHTTP library does not deallocate the reception buffer. Be sure to have the application deallocate the pointer to the reception buffer that is passed as the argument of the completion callback. Use the DWC_Free function to deallocate the reception buffer.
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.
url |
URL of download destination. |
bufferlen |
Size of the receive buffer. |
buffer_clear |
Indicates whether to deallocate the reception buffer after data is received. (TRUE: Deallocate, FALSE: Do not deallocate) |
post |
Pointer to the DWCGHTTPPost type object to be uploaded |
progressCallback |
The pointer to the callback function called during communication. |
completedCallback |
Pointer to the callback function called when the download is complete. |
param |
Callback parameter. |
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. |
DWC_GHTTPNewPost, DWC_ProcessGHTTP, DWCGHTTPProgressCallback, DWCGHTTPCompletedCallback, DWC_Free, DWC_GetGHTTPState
2006/12/27 Initial version.
CONFIDENTIAL