EvtGetLogInfo-Funktion (winevt.h)

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

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

Weitere Informationen

EvtOpenLog