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 HTTP request is denied by the server. 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 SF_REQ_ADD_HEADERS_ON_DENIAL,

  PVOID pData,

  DWORD ul1,

  DWORD ul2

);

Parameters

pfc

Points to the HTTP_FILTER_CONTEXT data structure that is associated with the current, active HTTP transaction.

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.