Microsoft Internet Security and Acceleration Server 2004 SDK

AddHeader

The AddHeader callback function adds an HTTP header to an incoming request after an SF_NOTIFY_PREPROC_HEADERS or SF_NOTIFY_AUTH_COMPLETE event notification, to an incoming response after an SF_NOTIFY_RECEIVE_RESPONSE_HEADERS notification, or to an outgoing response after an SF_NOTIFY_SEND_RESPONSE notification. For more information on the types of event notifications that are sent to Web filters, see Event Notifications.

The AddHeader callback function is declared as:

BOOL WINAPI * AddHeader(
  struct _HTTP_FILTER_CONTEXT* pfc,
  LPSTR lpszName ,
  LPSTR lpszValue
);

Parameters

pfc
Pointer to the HTTP_FILTER_CONTEXT data structure that is associated with the current, active HTTP session. Pass the filter context in this parameter.
lpszName
Pointer to a null-terminated string containing the name of the header to add. Header names should include the trailing colon (:). This parameter is not case-sensitive.
lpszValue
Pointer to a null-terminated string containing the new value to add to the header, or to \0 to add a header with an empty value.

Return Values

Returns TRUE if the function succeeded, or FALSE if the function failed.

Remarks

A pointer to this function is included as a member of the following structures:

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wpxhttpfilt.h.

See Also

Callback Functions