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 |