ServerSupportFunction Extension Function
The ServerSupportFunction function is a callback function that is supplied in the EXTENSION_CONTROL_BLOCK Structure that is associated with the current HTTP request. ServerSupportFunction can be used to perform a variety of tasks.
Note
If a parameter is designated as unused in a particular support function, you should set that parameter to NULL.
BOOL WINAPI ServerSupportFunction(
HCONN ConnID,
DWORD dwServerSupportFunction,
LPVOID lpvBuffer,
LPDWORD lpdwSizeofBuffer,
LPDWORD lpdwDataType
);
Parameters
ConnID
Specifies the connection identifier of the client to which the response data should be sent.dwServerSupportFunction
The name of one of the Server Support functions, listed in the following table.lpvBuffer
Points to a null-terminated string.lpdwSizeofBuffer
Points to the DWORD containing the size of the string contained in the buffer lpvBuffer.lpdwDataType
Points to a DWORD. If the particular server support function designates this parameter as unused, set it to NULL.
Return Values
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. The Win32? GetLastError function can be used to determine why the call failed. The following are the possible error values.
Return code |
Description |
|---|---|
ERROR_INVALID_PARAMETER |
Bad connection handle, or invalid values, in either lpszVariableName or lpdwSizeOfBuffer. |
ERROR_INVALID_INDEX |
Bad or unsupported variable identifier. |
ERROR_INSUFFICIENT_BUFFER |
Buffer too small. The required buffer size is *lpdwSizeofBuffer. |
ERROR_NO_DATA |
The data requested is not available. |
Requirements
Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Product: IIS
Header: Declared in httpext.h.