ghttpPostEx
Do a HTTP POST, which can be used to upload data to a web server.
- GHTTPRequest ghttpPostEx(
- const gsi_char * URL,
- const gsi_char * headers,
- GHTTPPost post,
- GHTTPBool throttle,
- GHTTPBool blocking,
- ghttpProgressCallback progressCallback,
- ghttpCompletedCallback completedCallback,
- void * param );
| Routine | Required Header | Distribution |
|---|---|---|
| ghttpPostEx | <ghttp.h> | SDKZIP |
Return Value
If less than 0, the request failed and this is a GHTTPRequestError value. Otherwise it identifies the request.
Parameters
- URL
- [in] URL
- headers
- [in] Optional headers to pass with the request. Can be NULL or "".
- post
- [in] The data to be posted.
- throttle
- [in] If true, throttle this connection's download speed.
- blocking
- [in] If true, this call doesn't return until finished.
- progressCallback
- [in] Called whenever new data is received. Can be NULL.
- completedCallback
- [in] Called when the file has finished streaming. Can be NULL.
- param
- [in] Optional free-format user data for use by the callback
Remarks
This function is used to post data to a web page, ignoring any possible response body sent by the server (response status and response headers can still be checked). If you want to post data and receive a response, use ghttpGetEx, ghttpSaveEx, or ghttpStreamEx.
Use ghttpPost for a simpler version of this function.
Section Reference: Gamespy HTTP SDK
See Also: ghttpGetEx, ghttpSaveEx, ghttpStreamEx, ghttpHeadEx, ghttpPost