EvtSetChannelConfigProperty-Funktion (winevt.h)

Legt die angegebene Konfigurationseigenschaft eines Kanals fest.

Syntax

BOOL EvtSetChannelConfigProperty(
  [in] EVT_HANDLE                     ChannelConfig,
  [in] EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in] DWORD                          Flags,
  [in] PEVT_VARIANT                   PropertyValue
);

Parameter

[in] ChannelConfig

Ein Handle für die Konfigurationseigenschaften des Kanals, die die EvtOpenChannelConfig-Funktion zurückgibt.

[in] PropertyId

Der Bezeichner der festzulegenden Kanaleigenschaft. Eine Liste der Eigenschaftenbezeichner finden Sie in der EVT_CHANNEL_CONFIG_PROPERTY_ID Enumeration.

[in] Flags

Reserviert. Muss Null sein.

[in] PropertyValue

Der festzulegende Eigenschaftswert.

Ein vom Aufrufer zugewiesener Puffer, der den neuen Konfigurationseigenschaftswert enthält. Der Puffer enthält ein EVT_VARIANT-Objekt . Achten Sie darauf, den Konfigurationswert und den Variantentyp festzulegen.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
TRUE	Die Funktion wurde erfolgreich ausgeführt.
FALSE	Fehler bei der Funktion. Um den Fehlercode abzurufen, rufen Sie die GetLastError-Funktion auf.

Hinweise

Diese Funktion ändert eine Im-Memory-Kopie der Konfigurationseigenschaften. Rufen Sie die EvtSaveChannelConfig-Funktion auf, um die Änderungen anzuwenden, die Sie auf mindestens eine der Konfigurationseigenschaften vorgenommen haben.

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

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig