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