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

Voir aussi

EVT_LOGIN_CLASS

EvtClose