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 |