Funzione EvtOpenSession (winevt.h)

Stabilisce una connessione a un computer remoto che è possibile usare quando si chiamano le altre funzioni del registro eventi di Windows.

Sintassi

EVT_HANDLE EvtOpenSession(
  [in] EVT_LOGIN_CLASS LoginClass,
  [in] PVOID           Login,
  [in] DWORD           Timeout,
  [in] DWORD           Flags
);

Parametri

[in] LoginClass

Metodo di connessione da usare per connettersi al computer remoto. Per i valori possibili, vedere l'enumerazione EVT_LOGIN_CLASS .

[in] Login

Struttura EVT_RPC_LOGIN che identifica il computer remoto a cui si vuole connettersi, le credenziali dell'utente e il tipo di autenticazione da usare durante la connessione.

[in] Timeout

Riservato. Deve essere zero.

[in] Flags

Riservato. Deve essere zero.

Valore restituito

In caso di esito positivo, la funzione restituisce un handle di sessione che è possibile usare per accedere alle informazioni del registro eventi nel computer remoto; in caso contrario, NULL. Se NULL, chiamare la funzione GetLastError per ottenere il codice di errore.

Commenti

Al termine dell'handle di sessione, chiamare la funzione EvtClose . La chiusura dell'handle di sessione chiuderà anche tutti gli handle aperti creati nella sessione (chiudendo gli handle aperti annulla qualsiasi attività corrente in tali handle).

Per connettersi al computer remoto, il computer remoto deve abilitare l'eccezione "Gestione log eventi remoti" di Windows Firewall; in caso contrario, quando si tenta di usare l'handle di sessione, la chiamata verrà eseguita con RPC_S_SERVER_UNAVAILABLE. Il computer a cui si sta connettendo deve essere in esecuzione Windows Vista o versione successiva.

Questa funzione non convalida le credenziali; le credenziali vengono convalidate la prima volta che si tenta di usare l'handle di sessione. Se le credenziali non sono valide, la chiamata avrà esito negativo con ERROR_ACCESS_DENIED.

Esempio

Per un esempio che illustra come usare questa funzione, vedere Accesso ai computer remoti.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winevt.h
Libreria Wevtapi.lib
DLL Wevtapi.dll

Vedi anche

EVT_LOGIN_CLASS

EvtClose