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 |