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
TRUE	La fonction a réussi.
FALSE	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

Voir aussi

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig