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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für