DWC_PostGHTTPData

Syntax

#include <dwc.h>

int DWC_PostGHTTPData( 
            const char* url,
            DWCGHTTPPost* post,
            DWCGHTTPCompletedCallback completedCallback,
            void* param );

Description

Uploads data to the URL specified with url.

In post, specify a DWCGHTTPPost type of object created by the DWC_GHTTPNewPost function for the data to be uploaded.

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 for the upload destination. NULL-terminated string.
post Pointer to the DWCGHTTPPost type object to be uploaded.
completedCallback Pointer to the callback function to call when upload 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_GHTTPNewPost
DWC_ProcessGHTTP
DWCGHTTPCompletedCallback
DWC_GetGHTTPState

Revision History

2007/10/15 To the description of the url argument, added text about the NULL terminator.
2006/12/27 Made revisions to reflect the addition of the DWC_GetGHTTPDataEx2 function.
2006/01/18 Added DWC_GHTTP_IN_ERROR to the return values.
2005/12/16 Revisions.
2005/10/27 Initial version.


CONFIDENTIAL