Funzione OpenThreadToken (processthreadsapi.h)

Articolo
08/25/2023

La funzione OpenThreadToken apre il token di accesso associato a un thread.

Sintassi

BOOL OpenThreadToken(
  [in]  HANDLE  ThreadHandle,
  [in]  DWORD   DesiredAccess,
  [in]  BOOL    OpenAsSelf,
  [out] PHANDLE TokenHandle
);

Parametri

[in] ThreadHandle

Handle per il thread il cui token di accesso viene aperto.

[in] DesiredAccess

Specifica una maschera di accesso che specifica i tipi richiesti di accesso al token di accesso. Questi tipi di accesso richiesti vengono riconciliati con l'elenco di controllo di accesso discrezionale del token per determinare quali accessi vengono concessi o negati.

Per un elenco dei diritti di accesso per i token di accesso, vedere Diritti di accesso per gli oggetti Access-Token.

[in] OpenAsSelf

TRUE se il controllo di accesso deve essere eseguito nel contesto di sicurezza a livello di processo.

FALSE se il controllo di accesso deve essere eseguito nel contesto di sicurezza corrente del thread che chiama la funzione OpenThreadToken .

Il parametro OpenAsSelf consente al chiamante di questa funzione di aprire il token di accesso di un thread specificato quando il chiamante rappresenta un token a livello di SecurityIdentification . Senza questo parametro, il thread chiamante non può aprire il token di accesso nel thread specificato perché non è possibile aprire oggetti a livello esecutivo usando il livello di rappresentazione di SecurityIdentification .

[out] TokenHandle

Puntatore a una variabile che riceve l'handle al token di accesso appena aperto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. Se il token ha il livello di rappresentazione anonimo, il token non verrà aperto e OpenThreadToken imposta ERROR_CANT_OPEN_ANONYMOUS come errore.

Commenti

Non è possibile aprire i token con il livello di rappresentazione anonima.

Chiudere l'handle del token di accesso restituito tramite il parametro TokenHandle chiamando CloseHandle.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	processthreadsapi.h (includere Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll