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

[in/out] The client's host name.

pszClientUserName

[in/out] The client's user name.

pszServerName

[in/out] The name of the server to which the client is connected.

pszOperation

[in/out] The HTTP command.

pszTarget

[in/out] The target of the HTTP command.

pszParameters

[in/out] The parameters passed to the HTTP command.

dwHttpStatus

[in/out] The HTTP return status.

dwWin32Status

[in/out] The Win32® error code.

dwBytesSent

[in/out] The number of bytes sent from the server to the client.

dwBytesRecvd

[in/out] The number of bytes received by the server from the client.

msTimeForProcessing

[in/out] 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 pointers can be replaced. If string pointers are changed, the memory they point to must remain valid so that the AllocMem callback function in the HTTP_FILTER_CONTEXT structure can be used.