HTTP_FILTER_SEND_RESPONSE

The ISA Server Web proxy includes a pointer to the HTTP_FILTER_SEND_RESPONSE structure in the notification that it sends to Web filters when ISA Server sends headers to the client. A filter can inspect, modify, or add headers that the client will receive as part of the response to the client's original request. The structure contains the same members as HTTP_FILTER_PREPROC_HEADERS. If your filter should be notified for this event, it must register to receive SF_NOTIFY_SEND_RESPONSE notifications. For more information about the types of event notifications that are sent to Web filters, see Event Notifications.

Note  An SF_NOTIFY_SEND_RESPONSE notification is not sent when ISA Server returns a response from a website or from the cache. However, it is sent when ISA Server creates a response, such as an error page, or when a filter generates a response by using SF_REQ_SEND_RESPONSE_HEADER.

typedef struct HTTP_FILTER_SEND_RESPONSE {

  BOOL (WINAPI)* GetHeader;

  BOOL (WINAPI)* SetHeader;

  BOOL (WINAPI)* AddHeader;

  DWORD HttpStatus;

  DWORD dwReserved;
} HTTP_FILTER_SEND_RESPONSE, 

*PHTTP_FILTER_SEND_RESPONSE;

Members

GetHeader

Pointer to the GetHeader function, which can be used to retrieve the specified header value. Header names should include the trailing colon (:).

SetHeader

Pointer to the SetHeader function, which can be used to modify or delete the value of a header. The function cannot be used to modify the portions included in the request line that are specified by the special values.

AddHeader

Pointer to the AddHeader callback function, which can be used to add an HTTP header to the response.

HttpStatus

The current HTTP status code.

dwReserved

A DWORD data type reserved for later use.

Remarks

The Web proxy sends an SF_NOTIFY_SEND_RESPONSE notification by calling the HttpFilterProc entry-point function of each Web filter that is registered to receive the notification. The pvNotification parameter contains a pointer to an HTTP_FILTER_SEND_RESPONSE structure, and the notificationType parameter is set to SF_NOTIFY_SEND_RESPONSE.

Requirements

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

See Also

Notification Structures