ServerSupportFunction Filter Function
The ServerSupportFunction callback function can be used by ISAPI filters to accomplish a wide variety of tasks.
Note
If a parameter is designated as unused for a particular support function, you should set the parameter to NULL or 0, as appropriate.
BOOL WINAPI ServerSupportFunction(
PHTTP_FILTER_CONTEXT pfc,
enum SF_REQ_TYPE sfServerSupportFunction,
PVOID pData,
DWORD ul1,
DWORD ul2
);
Parameters
pfc
Points to the HTTP_FILTER_CONTEXT Structure that is associated with the current, active HTTP transaction.sfServerSupportFunction
The name of one of the Server Support functions, listed in the following table.pData
This parameter has different uses in each server support function. If the particular server support function designates this parameter as unused, set it to NULL or 0, as appropriate.ul1
This parameter has different uses in each server support function. If the particular server support function designates this parameter as unused, set it to NULL or 0, as appropriate.ul2
This parameter has different uses in each server support function. If the particular server support function designates this parameter as unused, set it to NULL or 0, as appropriate.
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 httpfilt.h.