Microsoft Internet Security and Acceleration Server 2004 SDK

AddResponseHeaders

The AddResponseHeaders callback function adds a header to the HTTP response, if the response was created by ISA Server.

The AddResponseHeaders callback function is declared as:

BOOL WINAPI * AddResponseHeaders(
  struct _HTTP_FILTER_CONTEXT* pfc,
  LPSTR lpszHeaders,
  LPSTR dwReserved
);

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.
lpszHeaders
Pointer to a null-terminated string containing a string that contains the headers to add. The string should be in the following format: 
header1:value1\r\nheader2:value2\r\n
The string may contain one or more headers. Each header and value pair must be terminated by \r\n.
dwReserved
Reserved for future use. This must be zero.

Return Values

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

Remarks

The AddResponseHeaders callback function can be used to add headers to responses for clients before the server processes the request, but not during or after SF_NOTIFY_ACCESS_DENIED or SF_NOTIFY_SEND_RESPONSE notifications. You can add a header when the SF_NOTIFY_SEND_RESPONSE notification occurs by using the AddHeader member of the HTTP_FILTER_SEND_RESPONSE structure.

Headers are added by AddResponseHeaders only for responses generated by ISA Server, such as error pages, where SF_NOTIFY_SEND_RESPONSE is triggered. Use SF_NOTIFY_SEND_RAW_DATA to add headers to all responses. For more information on the types of event notifications that are sent to Web filters, see Event Notifications.

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