EXTENSION_CONTROL_BLOCK

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure is used by the Web Server and the ISAPI extension to exchange information.

Syntax

typedef struct _EXTENSION_CONTROL_BLOCK{
  DWORD cbSize;
  DWORD dwVersion;
  HCONN ConnID;
  DWORD dwHttpStatusCode;
  CHAR lpszLogData[HSE_LOG_BUFFER_LEN];
  LPSTR lpszMethod;
  LPSTR lpszQueryString;
  LPSTR lpszPathInfo;
  LPSTR lpszPathTranslated;
  DWORD cbTotalBytes;
  DWORD cbAvailable;
  LPBYTE lpbData;
  LPSTR lpszContentType;
  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

By default the web server will read in 48 KB of POST data, but this value can be modified in the registry. See Base Registry Settings (https://msdn2.microsoft.com/en-us/library/aa919492.aspx) for details.

Requirements