HTTP_FILTER_LOG

IIS includes a pointer to this structure when it is writing information to a log file. If your filter should be notified for this event, it should register for the SF_NOTIFY_LOG event.

typedef struct _HTTP_FILTER_LOG {

  const CHAR * pszClientHostName;

  const CHAR * pszClientUserName;

  const CHAR * pszServerName;

  const CHAR * pszOperation;

  const CHAR * pszTarget;

  const CHAR * pszParameters;

  DWORD dwHttpStatus;

  DWORD dwWin32Status;

  DWORD dwBytesSent;

  DWORD dwBytesRecvd;

  DWORD msTimeForProcessing;

} HTTP_FILTER_LOG, *PHTTP_FILTER_LOG;

 

Members
pszClientHostName
The client's host name.
pszClientUserName
The client's user name.
pszServerName
The name of the server to which the client is connected.
pszOperation
The HTTP operation type.
pszTarget
The target of the HTTP command.
pszParameters
The parameters passed to the HTTP command.
dwHttpStatus
The HTTP return status.
dwWin32Status
The Win32® error code.
dwBytesSent
The number of bytes sent from the server to the client.
dwBytesRecvd
The number of bytes received by the server from the client.
msTimeForProcessing
The time in milliseconds required to process the client request.
Remarks

When the server is about to log information to the server log file, this structure is pointed to by the pvNotification parameter in the HttpFilterProc function when the notificationType parameter is SF_NOTIFY_LOG. The strings cannot be changed, but the string pointers can be replaced. If string pointers are changed, the memory they point to must remain valid until the next filter notification. The AllocMem callback function in the HTTP_FILTER_CONTEXT structure can be used to ensure this.