Partager via


EvtOpenChannelConfig, fonction (winevt.h)

Obtient un handle que vous utilisez pour lire ou modifier la propriété de configuration d’un canal.

Syntaxe

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

Paramètres

[in] Session

Handle de session à distance que la fonction EvtOpenSession retourne. Définissez la valeur NULL pour accéder à un canal sur l’ordinateur local.

[in] ChannelPath

Nom du canal à accéder.

[in] Flags

Réservé. Doit être zéro.

Valeur retournée

Si elle réussit, la fonction retourne un handle à la configuration du canal ; sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.

Remarques

Pour obtenir une propriété de configuration, appelez la fonction EvtGetChannelConfigProperty .

Pour modifier une propriété de configuration, appelez la fonction EvtSetChannelConfigProperty . Pour enregistrer les modifications de configuration, appelez la fonction EvtSaveChannelConfig .

Pour énumérer les canaux inscrits, appelez la fonction EvtOpenChannelEnum .

Vous devez appeler la fonction EvtClose pour fermer le handle lorsque vous avez terminé.

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

   
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

EvtOpenChannelEnum

EvtSaveChannelConfig

EvtSetChannelConfigProperty