HTTP_FILTER_PREPROC_HEADERS Structure (IIS)

  • Article

IIS includes a pointer to this structure when it is preprocessing a request's headers. If your filter should be notified for this event, it should register for the SF_NOTIFY_PREPROC_HEADERS event.

typedef struct _HTTP_FILTER_PREPROC_HEADERS HTTP_FILTER_PREPROC_HEADERS {
      BOOL (WINAPI * GetHeader) ();
      BOOL (WINAPI * SetHeader) ();
      BOOL (WINAPI * AddHeader) ();
      DWORD HttpStatus;
      DWORD dwReserved;
} HTTP_FILTER_PREPROC_HEADERS, * PHTTP_FILTER_PREPROC_HEADERS;

Members

  • GetHeader
    Points to the GetHeader function, which retrieves the specified header value. Header names should include the trailing colon (:). The special values method, URL, and version can be used to retrieve the individual portions of the request line. The special values are case-sensitive and must not 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.

Remarks

When the server is about to process the client headers, this structure is pointed to by the pvNotification parameter in the HttpFilterProc when the notificationType parameter is set to SF_NOTIFY_PREPROC_HEADERS.

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.

See Also