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
| 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 |