GetHeader

The GetHeader callback function retrieves a header from IIS.

BOOL WINAPI * GetHeader(

  PHTTP_FILTER_CONTEXT pfc,

  LPSTR lpszName,

  LPVOID lpvBuffer,

  LPDWORD lpdwSize

);

Parameters

pfc

Points to the HTTP_FILTER_CONTEXT data structure that is associated with the current, active HTTP transaction.

lpszName

Points to the name of the header to retrieve.

lpvBuffer

Points to a buffer of size lpdwSize where the value of the header will be stored. This should be set to the size of the buffer lpvBuffer, for example, sizeof(achBuffer). 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.

lpdwSize

The size of the buffer.

Remarks

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 must not include the trailing colon.