EvtSetChannelConfigProperty, fonction (winevt.h)
Définit la propriété de configuration spécifiée d’un canal.
Syntaxe
BOOL EvtSetChannelConfigProperty(
[in] EVT_HANDLE ChannelConfig,
[in] EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
[in] DWORD Flags,
[in] PEVT_VARIANT PropertyValue
);
Paramètres
[in] ChannelConfig
Handle des propriétés de configuration du canal que la fonction EvtOpenChannelConfig retourne.
[in] PropertyId
Identificateur de la propriété de canal à définir. Pour obtenir la liste des identificateurs de propriétés, consultez l’énumération EVT_CHANNEL_CONFIG_PROPERTY_ID .
[in] Flags
Réservé. Doit être zéro.
[in] PropertyValue
Valeur de propriété à définir.
Mémoire tampon allouée à l’appelant qui contient la nouvelle valeur de propriété de configuration. La mémoire tampon contient un objet EVT_VARIANT . Veillez à définir la valeur de configuration et le type de variante.
Valeur retournée
Code/valeur de retour | Description |
---|---|
|
La fonction a réussi. |
|
La fonction a échoué. Pour obtenir le code d’erreur, appelez la fonction GetLastError . |
Remarques
Cette fonction modifie une copie en mémoire des propriétés de configuration. Pour appliquer les modifications que vous avez apportées à une ou plusieurs propriétés de configuration, appelez la fonction EvtSaveChannelConfig .
Exemples
Pour obtenir un exemple montrant comment utiliser cette fonction, consultez Obtention et définition des propriétés de configuration d’un canal.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winevt.h |
Bibliothèque | Wevtapi.lib |
DLL | Wevtapi.dll |