EvtSetChannelConfigProperty, fonction (winevt.h)

  • Article

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