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 records
);

Parameters

hEventLog

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

OldestRecord

[out] 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.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Event Logging Overview, Event Logging Functions, GetNumberOfEventLogRecords, OpenBackupEventLog, OpenEventLog