GetOldestEventLogRecord-Funktion (winbase.h)

Ruft die absolute Datensatznummer des ältesten Datensatzes im angegebenen Ereignisprotokoll ab.

Syntax

BOOL GetOldestEventLogRecord(
  [in]  HANDLE hEventLog,
  [out] PDWORD OldestRecord
);

Parameter

[in] hEventLog

Ein Handle für das geöffnete Ereignisprotokoll. Die OpenEventLog - oder OpenBackupEventLog-Funktion gibt dieses Handle zurück.

[out] OldestRecord

Ein Zeiger auf eine Variable, die die absolute Datensatznummer des ältesten Datensatzes im angegebenen Ereignisprotokoll empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der älteste Datensatz in einem Ereignisprotokoll ist nicht unbedingt DatensatzNummer 1. Weitere Informationen finden Sie unter Ereignisprotokolldatensätze.

Beispiele

Ein Beispiel finden Sie unter Abfragen von Ereignisinformationen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll
APIs	ext-ms-win-advapi32-eventlog-l1-1-1 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

Ereignisprotokollierungsfunktionen

GetNumberOfEventLogRecords

OpenBackupEventLog

OpenEventLog