HttpExtensionProc
The HttpExtensionProc function is the main entry point for an ISAPI extension called by the Web server. It exposes methods that the Web server uses to access the functionality exposed by the extension.
DWORD WINAPI HttpExtensionProc(
LPEXTENSION_CONTROL_BLOCK lpECB );
Parameters
- lpECB
Points to the EXTENSION_CONTROL_BLOCK data structure that is associated with the current, active request.
Return Values
Returns a DWORD containing HSE_STATUS codes. Possible return values are:
| Value | Description |
|---|---|
| HSE_STATUS_SUCCESS | The extension has finished processing and the server should disconnect the client and free up allocated resources. |
| HSE_STATUS_SUCCESS_AND_KEEP_CONN | The extension has finished processing and the server should wait for the next HTTP request if the client supports Keep-Alive connections. The extension can return this only if it was able to send the correct Content-Length header to the client. |
| HSE_STATUS_PENDING | This option is not supported in the Windows CE Web server. |
| HSE_STATUS_ERROR | The extension has encountered an error while processing the request, so the server can disconnect the client and free up allocated resources. An HTTP status code of 500 is written to the the Web server log for the request. |
Remarks
This entry point is similar to a main() function in a C++ program. The code in this entry point uses callback functions in the EXTENSION_CONTROL_BLOCK to read client data and decide which action to take. Before returning to the server, a properly formatted response must be sent to the client through either WriteClient or ServerSupportFunction. Return codes are defined in httpext.h.
Important The Windows CE Web server performs a keep-alive if ISAPI extension returns HSE_STATUS_SUCCESS_AND_KEEP_CONN.
This function is not exported by the httpextn component of the Windows CE operating system.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 3.0 and later | httpext.h |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
httpextn component, EXTENSION_CONTROL_BLOCK
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.