EvtOpenChannelEnum-Funktion (winevt.h)

Ruft ein Handle ab, das Sie zum Auflisten der Liste der Kanäle verwenden, die auf dem Computer registriert sind.

Syntax

EVT_HANDLE EvtOpenChannelEnum(
  [in] EVT_HANDLE Session,
  [in] DWORD      Flags
);

Parameter

[in] Session

Ein Remotesitzungshandle, das die EvtOpenSession-Funktion zurückgibt. Legen Sie auf NULL fest, um die Kanäle auf dem lokalen Computer aufzulisten.

[in] Flags

Reserviert. Muss Null sein.

Rückgabewert

Bei erfolgreicher Ausführung gibt die Funktion ein Handle für die Liste der Kanalnamen zurück, die auf dem Computer registriert sind. andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Die Enumeration umfasst alle Kanäle, die die Anbieter definiert haben, die auf dem Computer registriert sind. Um die Kanalnamen aufzulisten, rufen Sie die Funktion EvtNextChannelPath in einer Schleife auf. Die Namen werden alphabetisch sortiert.

Sie müssen die EvtClose-Funktion aufrufen, um das Enumeratorhandle zu schließen.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Abrufen und Festlegen der Konfigurationseigenschaften eines Kanals.

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

EvtNextChannelPath

EvtOpenChannelConfig