EvtOpenChannelConfig-Funktion (winevt.h)

Artikel
08/27/2023

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