EvtOpenChannelConfig-Funktion (winevt.h)
Ruft ein Handle ab, das Sie zum Lesen oder Ändern der Konfigurationseigenschaft eines Kanals verwenden.
Syntax
EVT_HANDLE EvtOpenChannelConfig(
[in] EVT_HANDLE Session,
[in] LPCWSTR ChannelPath,
[in] DWORD Flags
);
Parameter
[in] Session
Ein Remotesitzungshandle, das von der EvtOpenSession-Funktion zurückgegeben wird. Legen Sie auf NULL fest, um auf einen Kanal auf dem lokalen Computer zuzugreifen.
[in] ChannelPath
Der Name des Kanals, auf den zugegriffen werden soll.
[in] Flags
Reserviert. Muss Null sein.
Rückgabewert
Bei erfolgreicher Ausführung gibt die Funktion ein Handle für die Konfiguration des Kanals zurück. andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.
Hinweise
Um eine Konfigurationseigenschaft abzurufen, rufen Sie die EvtGetChannelConfigProperty-Funktion auf.
Um eine Konfigurationseigenschaft zu ändern, rufen Sie die EvtSetChannelConfigProperty-Funktion auf. Rufen Sie die EvtSaveChannelConfig-Funktion auf, um die Konfigurationsänderungen zu speichern.
Rufen Sie die EvtOpenChannelEnum-Funktion auf, um die registrierten Kanäle aufzulisten.
Sie müssen die EvtClose-Funktion aufrufen, um das Handle zu schließen, wenn Sie fertig sind.
Beispiele
Ein Beispiel zur Verwendung dieser Funktion finden Sie unter Abrufen und Festlegen der Konfigurationseigenschaften eines Kanals.
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 |