HTTP_FILTER_SEND_RESPONSE Structure

  • Article

ISAPI filters receive this notification immediately prior to sending the headers to the client. The filter can inspect, modify, or add headers 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. When a filter has registered for the SF_NOTIFY_SEND_RESPONSE event, the pvNotification parameter of HttpFilterProc will point to this structure.

typedef struct HTTP_FILTER_SEND_RESPONSE 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
    Points to the GetHeader function, which retrieves the specified header value. Header names must include the trailing colon (:).

  • SetHeader
    Points to the SetHeader function, which changes or deletes the value of a header. The function can be used to change the special values included in the request line.

  • AddHeader
    Points to the AddHeader function to add a header to the response.

  • HttpStatus
    The current HTTP status code.

  • dwReserved
    A DWORD reserved for later use.

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.