SF_REQ_GET_PROPERTY

  • Article

You can use this support function to retrieve special IIS properties defined in SF_PROPERTY_IIS.

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 the Server Support function, which in this case must be set to SF_REQ_GET_PROPERTY.

  • pData
    Points to a buffer that will contain the property requested.

  • ul1
    Specifies the property ID, as described in SF_PROPERTY_IIS.

  • ul2
    Unused in this support function.

Remarks

The only valid value for ul1 is SF_PROPERTY_INSTANCE_NUM_ID. Your ISAPI filter can use this property to discover the server instance number for the current request. This information could then be used to access the metabase, for example. Note that if your ISAPI filter calls this support function before the preproc headers event, IIS will not yet know which server instance is handling the request, and pData will be set to NULL.

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.