Condividi tramite


Funzione OpenThreadToken (processthreadsapi.h)

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

Vedi anche

Panoramica Controllo di accesso

AccessCheck

AdjustTokenGroups

RegolaTokenPrivileges

Funzioni di base Controllo di accesso

Closehandle

GetCurrentThreadToken

GetTokenInformation

OpenProcessToken

SECURITY_IMPERSONATION_LEVEL

SetThreadToken

SetTokenInformation