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 |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
|
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 |