EvtGetLogInfo-Funktion (winevt.h)

Artikel
03/04/2024

Ruft Informationen zu einem Kanal oder einer Protokolldatei ab.

Syntax

BOOL EvtGetLogInfo(
  [in]  EVT_HANDLE          Log,
  [in]  EVT_LOG_PROPERTY_ID PropertyId,
  [in]  DWORD               PropertyValueBufferSize,
  [in]  PEVT_VARIANT        PropertyValueBuffer,
  [out] PDWORD              PropertyValueBufferUsed
);

Parameter

[in] Log

Ein Handle für den Kanal oder die Protokolldatei, die von der EvtOpenLog-Funktion zurückgegeben wird.

[in] PropertyId

Der Bezeichner der abzurufenden Eigenschaft. Eine Liste der Eigenschaftenbezeichner finden Sie in der EVT_LOG_PROPERTY_ID-Enumeration .

[in] PropertyValueBufferSize

Die Größe des PropertyValueBuffer-Puffers in Bytes.

[in] PropertyValueBuffer

Ein vom Aufrufer zugeordneter Puffer, der den Eigenschaftswert empfängt. Der Puffer enthält ein EVT_VARIANT-Objekt . Sie können diesen Parameter auf NULL festlegen, um die erforderliche Puffergröße zu bestimmen.

[out] PropertyValueBufferUsed

Die Größe des vom Aufrufer zugewiesenen Puffers in Bytes, den die Funktion verwendet hat, oder die erforderliche Puffergröße, wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
TRUE	Die Funktion wurde erfolgreich ausgeführt.
FALSE	Fehler bei der Funktion. Rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Sie können vollständige Informationen für Betriebs- und Admin kanäle oder EVTX-Dateien abrufen. Für Debug- und Analysekanäle oder ETL-Dateien können Sie jedoch keine Informationen für die Eigenschaften EvtLogFull, EvtLogOldestRecordNumber und EvtLogNumberOfLogRecords abrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winevt.h
Bibliothek	Wevtapi.lib
DLL	Wevtapi.dll

Weitere Informationen

EvtOpenLog

Freigeben über