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.

  SF_REQ_ADD_HEADERS_ON_DENIAL

  SF_REQ_DISABLE_NOTIFICATIONS

  SF_REQ_GET_CONNID

  SF_REQ_GET_PROPERTY

  SF_REQ_NORMALIZE_URL

  SF_REQ_SEND_RESPONSE_HEADER

  SF_REQ_SET_NEXT_READ_SIZE

  SF_REQ_SET_PROXY_INFO

• 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.