SF_REQ_ADD_HEADERS_ON_DENIAL

  • Article

This support function allows your ISAPI filter to add specified headers to the server error response, in the event that the server denies the HTTP request. This allows an authentication filter to advertise its services without filtering every request.

Note

This support function will not work properly if called during the processing of a SF_NOTIFY_SEND_RAW_DATA notification.

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

  • pData
    Null-terminated string pointing to one or more HTTP header lines. Each individual header should be terminated with a carriage return and linefeed.

  • ul1
    Unused in this support function.

  • ul2
    Unused in this support function.

Remarks

Generally, the HTTP headers should be WWW-Authenticate headers, specifying custom authentication schemes. However, no restriction is placed on which headers can be specified. IIS will advertise both Basic and integrated Windows authentication, individually and collectively, if those authentication schemes are enabled.

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.