GetEventLogInformation-Funktion (winbase.h)
Ruft Informationen zum angegebenen Ereignisprotokoll ab.
Syntax
BOOL GetEventLogInformation(
[in] HANDLE hEventLog,
[in] DWORD dwInfoLevel,
[out] LPVOID lpBuffer,
[in] DWORD cbBufSize,
[out] LPDWORD pcbBytesNeeded
);
Parameter
[in] hEventLog
Ein Handle für das Ereignisprotokoll. Die OpenEventLog - oder RegisterEventSource-Funktion gibt dieses Handle zurück.
[in] dwInfoLevel
Die Ebene der zurückzugebenden Ereignisprotokollinformationen.
Dieser Parameter kann der folgende Wert sein.
| Wert | Bedeutung |
|---|---|
|
Geben Sie an, ob das angegebene Protokoll voll ist. Der lpBuffer-Parameter enthält eine EVENTLOG_FULL_INFORMATION-Struktur . |
[out] lpBuffer
Ein von der Anwendung zugewiesener Puffer, der die Ereignisprotokollinformationen empfängt. Das Format dieser Daten hängt vom Wert des dwInfoLevel-Parameters ab.
[in] cbBufSize
Die Größe des lpBuffer-Puffers in Bytes.
[out] pcbBytesNeeded
Die Funktion legt diesen Parameter auf die erforderliche Puffergröße für die angeforderten Informationen fest, unabhängig davon, ob die Funktion erfolgreich ist. Verwenden Sie diesen Wert, wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt, um einen Puffer der richtigen Größe zuzuweisen.
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.
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 |