GetOldestEventLogRecord

The GetOldestEventLogRecord function retrieves the absolute record number of the oldest record in the specified event log.

BOOL GetOldestEventLogRecord(
  HANDLE hEventLog,     // handle to event log
  PDWORD OldestRecord   // buffer for number of oldest record
);
 

Parameters

hEventLog

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

OldestRecord

Pointer to the buffer that receives the absolute record number of the oldest record 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, GetNumberOfEventLogRecords, OpenBackupEventLog, OpenEventLog