EvtOpenSession, fonction (winevt.h)
Établit une connexion à un ordinateur distant que vous pouvez utiliser lors de l’appel des autres fonctions du journal des événements Windows.
Syntaxe
EVT_HANDLE EvtOpenSession(
[in] EVT_LOGIN_CLASS LoginClass,
[in] PVOID Login,
[in] DWORD Timeout,
[in] DWORD Flags
);
Paramètres
[in] LoginClass
Méthode de connexion à utiliser pour se connecter à l’ordinateur distant. Pour connaître les valeurs possibles, consultez l’énumération EVT_LOGIN_CLASS .
[in] Login
Structure EVT_RPC_LOGIN qui identifie l’ordinateur distant auquel vous souhaitez vous connecter, les informations d’identification de l’utilisateur et le type d’authentification à utiliser lors de la connexion.
[in] Timeout
Réservé. Doit être zéro.
[in] Flags
Réservé. Doit être zéro.
Valeur retournée
Si elle réussit, la fonction retourne un handle de session que vous pouvez utiliser pour accéder aux informations du journal des événements sur l’ordinateur distant . sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.
Remarques
Lorsque vous avez terminé avec le handle de session, appelez la fonction EvtClose . La fermeture du handle de session ferme également tous les handles ouverts créés dans la session (la fermeture des handles ouverts annule toute activité actuelle sur ces handles).
Pour se connecter à l’ordinateur distant, l’ordinateur distant doit activer l’exception de pare-feu Windows « Gestion du journal des événements à distance » ; sinon, lorsque vous essayez d’utiliser le handle de session, l’appel entraîne une erreur avec RPC_S_SERVER_UNAVAILABLE. L’ordinateur auquel vous vous connectez doit exécuter Windows Vista ou une version ultérieure.
Cette fonction ne valide pas les informations d’identification ; les informations d’identification sont validées la première fois que vous essayez d’utiliser le handle de session. Si les informations d’identification ne sont pas valides, l’appel échoue avec ERROR_ACCESS_DENIED.
Exemples
Pour obtenir un exemple montrant comment utiliser cette fonction, consultez Accès aux ordinateurs distants.
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 |