Make a HTTP HEAD request, which will only retrieve the response headers and not the normal response body.

GHTTPRequest ghttpHeadEx(

const gsi_char * URL,

const gsi_char * headers,

GHTTPBool throttle,

GHTTPBool blocking,

ghttpProgressCallback progressCallback,

ghttpCompletedCallback completedCallback,

void * param );

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 "".

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 request has finished. Can be NULL.

param

[in] Optional free-format user data for use by the callback

Remarks

This function is similar to ghttpGetEx, except it onlyl gets the response headers. This is done by making an HEAD request instead of a GET request, which instructs the HTTP server to leave the body out of the response.
Use ghttpHead for a simpler version of this function.

Section Reference: Gamespy HTTP SDK

See Also: ghttpGetEx, ghttpSaveEx, ghttpStreamEx, ghttpHead, ghttpPostEx