EvtOpenLog-Funktion (winevt.h)

Ruft ein Handle für einen Kanal oder eine Protokolldatei ab, die Sie dann verwenden können, um Informationen über den Kanal oder die Protokolldatei abzurufen.

Syntax

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

Parameter

[in] Session

Ein Remotesitzungshandle, das die EvtOpenSession-Funktion zurückgibt. Legen Sie auf NULL fest, um einen Kanal zu öffnen oder sich auf dem lokalen Computer anzumelden.

[in] Path

Der Name des Kanals oder der vollständige Pfad zur exportierten Protokolldatei.

[in] Flags

Ein Flag, das bestimmt, ob der Path-Parameter auf eine Protokolldatei oder einen Kanal verweist. Mögliche Werte finden Sie in der EVT_OPEN_LOG_FLAGS-Enumeration .

Rückgabewert

Bei erfolgreicher Ausführung gibt die Funktion ein Handle an die Datei oder den Kanal zurück. andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Relative Pfade und Umgebungsvariablen können beim Angeben einer Datei nicht verwendet werden. Zum Suchen der Datei kann ein UNC-Pfad (Universal Naming Convention) verwendet werden. Jede relative Pfad- und Umgebungsvariablenerweiterung muss vor dem Ausführen von API-Aufrufen erfolgen.

Rufen Sie die EvtGetLogInfo-Funktion auf, um Informationen zum Kanal oder zur Protokolldatei abzurufen.

Anforderungen

Weitere Informationen

EvtClearLog

EvtExportLog

EvtGetLogInfo