L_InetHttpGetServerStatus
#include "ltweb.h"
L_LTWEB_API L_INT L_InetHttpGetServerStatus(hHttp, uStatus)
HINET hHttp; |
/* handle to an HTTP connection*/ |
L_UINT *uStatus; |
/* address of variable to be updated*/ |
Gets the status of the last request sent to the HTTP server.
Parameter |
Description |
|
hHttp |
Handle to the HTTP connection. This is the same handle obtained using the L_InetHttpConnect function. |
|
uStatus |
Pointer to the variable to be updated with the current status of the HTTP server. Possible values are: |
|
|
Value |
Meaning |
|
L_HTTP_STATUS_OK |
request completed |
|
L_HTTP_STATUS_CREATED |
object created, reason = new URI |
|
L_HTTP_STATUS_ACCEPTED |
asynchronous completion (TBS) |
|
L_HTTP_STATUS_PARTIAL |
partial completion |
|
L_HTTP_STATUS_NO_CONTENT |
no information to return |
|
L_HTTP_STATUS_RESET_CONTENT |
request completed, but clear form |
|
L_HTTP_STATUS_PARTIAL_CONTENT |
partial GET fulfilled |
|
L_HTTP_STATUS_AMBIGUOUS |
server couldn't decide what to return |
|
L_HTTP_STATUS_MOVED |
object permanently moved |
|
L_HTTP_STATUS_REDIRECT |
object temporarily moved |
|
L_HTTP_STATUS_REDIRECT_METHOD |
redirection w/ new access method |
|
L_HTTP_STATUS_NOT_MODIFIED |
requested resource has not been modified |
|
L_HTTP_STATUS_USE_PROXY |
redirection to proxy, location header specifies proxy to use |
|
L_HTTP_STATUS_REDIRECT_KEEP_VERB |
HTTP/1.1: keep same verb |
|
L_HTTP_STATUS_BAD_REQUEST |
invalid syntax |
|
L_HTTP_STATUS_DENIED |
access denied |
|
L_HTTP_STATUS_PAYMENT_REQ |
payment required |
|
L_HTTP_STATUS_FORBIDDEN |
request forbidden |
|
L_HTTP_STATUS_NOT_FOUND |
object not found |
|
L_HTTP_STATUS_BAD_METHOD |
method is not allowed |
|
L_HTTP_STATUS_NONE_ACCEPTABLE |
no response acceptable to client found |
|
L_HTTP_STATUS_PROXY_AUTH_REQ |
proxy authentication required |
|
L_HTTP_STATUS_REQUEST_TIMEOUT |
server timed out waiting for request |
|
L_HTTP_STATUS_CONFLICT |
user should resubmit with more info |
|
L_HTTP_STATUS_GONE |
the resource is no longer available |
|
L_HTTP_STATUS_LENGTH_REQUIRED |
the server refused to accept request w/o a length |
|
L_HTTP_STATUS_PRECOND_FAILED |
precondition given in request failed |
|
L_HTTP_STATUS_REQUEST_TOO_LARGE |
request entity was too large |
|
L_HTTP_STATUS_URI_TOO_LONG |
request URI too long |
|
L_HTTP_STATUS_UNSUPPORTED_MEDIA |
unsupported media type |
|
L_HTTP_STATUS_SERVER_ERROR |
internal server error |
|
L_HTTP_STATUS_NOT_SUPPORTED |
server does not support the functionality required to fulfill the request |
|
L_HTTP_STATUS_BAD_GATEWAY |
error response received from gateway |
|
L_HTTP_STATUS_SERVICE_UNAVAIL |
temporarily overloaded |
|
L_HTTP_STATUS_GATEWAY_TIMEOUT |
timed out waiting for gateway |
|
L_HTTP_STATUS_VERSION_NOT_SUP |
HTTP version not supported |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Required DLLs and Libraries
LTWEB For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
See Also
Functions: |
L_InetHttpConnect, L_InetHttpDisconnect, L_InetHttpOpenRequest, L_InetHttpCloseRequest. |
Topics: |
|
|
Example
For an example, refer to L_InetHttpConnect.