HTTP_FILTER_LOG

The ISA Server Web proxy includes a pointer to the HTTP_FILTER_LOG structure when it is writing information to a log file. If your filter should be notified for this event, it must register to receive SF_NOTIFY_LOG notifications. For more information about the types of event notifications that are sent to Web filters, see Event Notifications.

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 or IP address.

pszClientUserName

Null-terminated string that specifies the client's user name if authenticated, or "anonymous" otherwise.

pszServerName

Null-terminated string that specifies the name of the server to which the client is connected.

pszOperation

Null-terminated string that specifies the HTTP method.

pszTarget

Null-terminated string that specifies the target of the HTTP command.

pszParameters

Null-terminated string that specifies the parameters passed to the HTTP command.

dwHttpStatus

The HTTP return status.

dwWin32Status

The Windows 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.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wpxhttpfilt.h.

See Also

Notification Structures