GetNumberOfEventLogRecords

The GetNumberOfEventLogRecords function retrieves the number of records in the specified event log.

BOOL GetNumberOfEventLogRecords(
  HANDLE hEventLog,        // handle to event log
  PDWORD NumberOfRecords   // buffer for number of records
);
 

Parameters

hEventLog

Handle to the open event log. This handle is returned by the OpenEventLog or OpenBackupEventLog function.

NumberOfRecords

Pointer to the buffer that receives the number of records in the specified event log.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winbase.h.
  Import Library: Use advapi32.lib.

See Also

Event Logging Overview, Event Logging Functions, GetOldestEventLogRecord, OpenBackupEventLog, OpenEventLog