GetNumberOfEventLogRecords-Funktion (winbase.h)

  • Artikel

Ruft die Anzahl der Datensätze im angegebenen Ereignisprotokoll ab.

Syntax

BOOL GetNumberOfEventLogRecords(
  [in]  HANDLE hEventLog,
  [out] PDWORD NumberOfRecords
);

Parameter

[in] hEventLog

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

[out] NumberOfRecords

Ein Zeiger auf eine Variable, die die Anzahl von Datensätzen 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 Datensatz Nummer 1. Verwenden Sie die GetOldestEventLogRecord-Funktion , um die älteste Datensatznummer in einem Ereignisprotokoll zu ermitteln.

Anforderungen

   
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 (einschließlich Windows.h)
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

GetOldestEventLogRecord

OpenBackupEventLog

OpenEventLog