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:

HTTP Functions: HTTP Connections

 

Working with HTTP Functions

Example

For an example, refer to L_InetHttpConnect.