Share via

CHttpServer::HttpExtensionProc

  • Article

**virtual DWORD HttpExtensionProc( EXTENSION_CONTROL_BLOCK ***pECB );

Return Value

One of the following HTTP Server Extension messages:

HSE_STATUS_SUCCESS

The ISA has finished processing and the server can disconnect and free up allocated resources.

HSE_STATUS_SUCCESS_AND_KEEP_CONN

The ISA has finished processing and the server should wait for the next HTTP request if the client supports persistent connections. The application should only return this if it was able to send the correct content-length header to the client. The server is not required to keep the session open.

HSE_STATUS_PENDING

The ISA has queued the request for processing and will notify the server when it has finished. See HSE_REQ_DONE_WITH_SESSION under CHttpServerContext::ServerSupportFunction.

HSE_STATUS_ERROR

The ISA has encountered an error while processing the request and the server can disconnect and free up allocated resources.

Parameters

pECB

A pointer to an EXTENSION_CONTROL_BLOCK structure.

Remarks

This member function is called by the framework for each request for an ISA. HttpExtensionProc uses the callback functions to read client data and decide what action to take. Before returning to the server, a properly formatted response must be sent to the client via either the CHttpServerContext::WriteClient or the CHttpServerContext::ServerSupportFunction member function.

The default implementation of HttpExtensionProc is recommended; however you can override this member function to customize the implementation.

CHttpServer Overview |  Class Members |  Hierarchy Chart

See Also   CHttpServerContext::WriteClient, CHttpServerContext::ServerSupportFunction