HTTP_FILTER_PREPROC_HEADERS

typedef struct _HTTP_FILTER_PREPROC_HEADERS

{ 

BOOL    (WINAPI * GetHeader) (   

    struct _HTTP_FILTER_CONTEXT *    pfc,

    LPSTR    lpszName,

    LPVOID   lpvBuffer,

    LPDWORD  lpdwSize

    );    

BOOL    (WINAPI * SetHeader) (    

    struct _HTTP_FILTER_CONTEXT *    pfc,

    LPSTR    lpszName,

    LPSTR    lpszValue

    );     

BOOL    (WINAPI * AddHeader) (    

    struct _HTTP_FILTER_CONTEXT *    pfc,

    LPSTR    lpszName,

    LPSTR    lpszValue

    );     

DWORD    dwReserved;    

} HTTP_FILTER_PREPROC_HEADERS, *PHTTP_FILTER_PREPROC_HEADERS;

Members

BOOL (WINAPI * GetHeader) (
    struct _HTTP_FILTER_CONTEXT * pfc,
    LPSTR lpszName,
    LPVOID lpvBuffer,
    LPDWORD lpdwSizeofBuffer
   );

A pointer to a function that 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.

Parameters

pfc

The filter context for this request from the pfc passed to the HttpFilterProc.

lpszName

The name of the header to retrieve.

lpvBuffer

A pointer to a buffer of size lpdwSizeofBuffer where the value of the header will be stored.

lpdwSizeofBuffer

This should be set to the size of the buffer lpvBuffer, for example, sizeof(lpvBuffer). After the call, it contains the number of bytes retrieved including the null terminator. Therefore, for retrieved strings it is equal to strlen(lpvBuffer)+1.

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

A pointer to a function used to change or delete the value of a header.

Parameters

pfc

The filter context for this request from the pfc passed to the HttpFilterProc.

lpszName

A pointer to the name of the header to change or delete.

lpszValue

A pointer to the string to change the header to, or a pointer to  \0  to delete the header.

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

A pointer to a function to add a header.

Parameters

pfc

The filter context for this request from the pfc passed to the HttpFilterProc.

lpszName

A pointer to the name of the header to change or delete.

lpszValue

A pointer to the string to change the header to, or a pointer to  \0  to delete the header.

Remarks

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

See Also