Funzione WTSQueryUserToken (wtsapi32.h)

Articolo
08/28/2023

Ottiene il token di accesso primario dell'utente connesso specificato dall'ID sessione. Per chiamare correttamente questa funzione, l'applicazione chiamante deve essere in esecuzione nel contesto dell'account LocalSystem e disporre del privilegio SE_TCB_NAME .

AttenzioneWTSQueryUserToken è destinato ai servizi altamente attendibili. I provider di servizi devono usare cautela per non perdere i token utente quando si chiama questa funzione. I provider di servizi devono chiudere gli handle dei token al termine dell'uso.

Sintassi

BOOL WTSQueryUserToken(
  [in]  ULONG   SessionId,
  [out] PHANDLE phToken
);

Parametri

[in] SessionId

Identificatore di sessione di Servizi Desktop remoto. Qualsiasi programma in esecuzione nel contesto di un servizio avrà un identificatore di sessione pari a zero (0). È possibile usare la funzione WTSEnumerateSessions per recuperare gli identificatori di tutte le sessioni in un server host sessione Desktop remoto specificato.

Per poter eseguire query sulle informazioni per la sessione di un altro utente, è necessario disporre dell'autorizzazione Informazioni query. Per altre informazioni, vedere Autorizzazioni di Servizi Desktop remoto. Per modificare le autorizzazioni in una sessione, usare lo strumento di amministrazione Configurazione servizi Desktop remoto.

[out] phToken

Se la funzione ha esito positivo, riceve un puntatore all'handle del token per l'utente connesso. Si noti che è necessario chiamare la funzione CloseHandle per chiudere questo handle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero e il parametro phToken punta al token primario dell'utente.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per informazioni sui token primari, vedere Token di accesso. Per altre informazioni sui privilegi dell'account, vedere Autorizzazioni e costanti di autorizzazione per Servizi Desktop remoto.

Per informazioni sui privilegi associati a tale account, vedere Account LocalSystem .

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll
Set di API	ext-ms-win-session-wtsapi32-l1-1-0 (introdotto in Windows 8)

Vedi anche

Closehandle

WTSEnumerateSessions

Condividi tramite