Share via


PfMakeLog

[PfMakeLog is available for use in the operating systems listed in the Requirements section. In Windows Server "Longhorn", this function returns ERROR_CALL_NOT_SUPPORTED. The MprConfigInterfaceTransportSetInfo function and the Windows Filtering Platform API Management Functions provide similar functionality.]

The PfMakeLog function creates a log to use with an interface or set of interfaces.

WORD PfMakeLog(
  HANDLE hEvent
);

Parameters

  • hEvent
    [in] Handle to an event object. The caller can use this event object to obtain notification when a specified number of bytes have been used in the log's buffer, or when a certain number of entries have been created in the log. For more information, see PfSetLogBuffer.

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, use FormatMessage to obtain the message string for the returned error.

Remarks

Only one log exists. The log can be used with multiple interfaces.

The interface log must be created before the interfaces with which it is used. It is not possible to associate a log with an already existing interface.

Requirements

Server Requires Windows Server 2003 or Windows 2000 Server.
Header

Declared in Fltdefs.h.

Library

Use Iphlpapi.lib.

DLL Requires Iphlpapi.dll.

See Also

PfDeleteLog
PfSetLogBuffer