EXTENSION_CONTROL_BLOCK (Windows CE 5.0)
This structure is used by the Web Server and the ISAPI extension to exchange information.
typedef struct _EXTENSION_CONTROL_BLOCK{DWORDcbSize;DWORDdwVersion;HCONNConnID;DWORDdwHttpStatusCode;CHAR lpszLogData[HSE_LOG_BUFFER_LEN];LPSTRlpszMethod;LPSTRlpszQueryString;LPSTRlpszPathInfo;LPSTRlpszPathTranslated;DWORDcbTotalBytes;DWORDcbAvailable;LPBYTElpbData;LPSTRlpszContentType;BOOL (WINAPI* GetServerVariable);BOOL (WINAPI* WriteClient);BOOL (WINAPI* ReadClient);BOOL (WINAPI* ServerSupportFunction);} EXTENSION_CONTROL_BLOCK, LPEXTENSION_CONTROL_BLOCK;
Members
- cbSize
Size of this structure. - dwVersion**
Version information of the extension specification. The HIWORD contains the major version number, and the LOWORD contains the minor version number. - ConnID**
A unique number assigned by the Web Server. This number should not be modified. - dwHttpStatusCode**
Status of the current transaction when the request is completed. The Web Server sets this variable to 200 and ignores any changes the extension might make to this variable. - lpszLogData**
Pointer to a buffer that contains a null-terminated log information string, specific to the ISAPI extension, for the current transaction. This log information will be entered into the Web Server log. Maintaining a single log file with both Web Server and ISAPI extension transactions is useful for administration purposes. - lpszMethod**
Pointer to the method with which the request was made, for example, GET or POST. This value is equivalent to the CGI variable REQUEST_METHOD. - lpszQueryString**
Pointer to a null-terminated string representing query information. This is the part of the URL string that appears after the question mark (?). This value is equivalent to the CGI variable QUERY_STRING. - lpszPathInfo**
Pointer to a null-terminated string that contains extra path information given by the client. This is the part of the string that appears between the DLL or script name in the URL and the question mark (?). The value is equivalent to the CGI variable PATH_INFO. - lpszPathTranslated
Pointer to a null-terminated string that contains the translated path. This value is equivalent to the CGI variable PATH_TRANSLATED. - cbTotalBytes
Total number of bytes to be received from the client. - cbAvailable
Available number of bytes (out of a total of cbTotalBytes) in the buffer indicated by lpbData. If cbTotalBytes is the same as cbAvailable, the member lpbData will indicate a buffer that contains all the data sent by the client. Otherwise, cbTotalBytes will contain the total number of bytes of data received. - lpbData
Pointer to a buffer of size cbAvailable that contains the data sent by the client. - lpszContentType
Pointer to a null-terminated string containing the content type of the data sent by the client. This value is equivalent to the CGI variable CONTENT_TYPE. - GetServerVariable
Pointer to the GetServerVariable (ISAPI Extensions) function for the extension. - WriteClient**
Pointer to the WriteClient (ISAPI Extensions) function for the extension. - ReadClient**
Pointer to the ReadClient function for the extension. - ServerSupportFunction**
Pointer to the ServerSupportFunction (ISAPI Extensions) for the extension.
Remarks
The default maximum number of bytes of POST data that will be read in is 4 GB. However, the maximum can be set to any size in the range of 0 bytes to 4 GB. This value can be changed in the HKEY_LOCAL_MACHINE\COMM\HTTPD\PostReadSize registry key.
Requirements
Pocket PC: Pocket PC 2000 and later.
Smartphone: Smartphone 2002 and later.
OS Versions: Windows CE 3.0 and later.
Header: Httpext.h
Send Feedback on this topic to the authors