Condividi tramite


Funzione SetThreadToken (processthreadsapi.h)

La funzione SetThreadToken assegna un token di rappresentazione a un thread. La funzione può anche causare l'arresto di un thread usando un token di rappresentazione.

Sintassi

BOOL SetThreadToken(
  [in, optional] PHANDLE Thread,
  [in, optional] HANDLE  Token
);

Parametri

[in, optional] Thread

Puntatore a un handle al thread a cui la funzione assegna il token di rappresentazione.

Se Thread è NULL, la funzione assegna il token di rappresentazione al thread chiamante.

[in, optional] Token

Handle per il token di rappresentazione da assegnare al thread. Questo handle deve essere stato aperto con diritti di accesso TOKEN_IMPERSONATE. Per altre informazioni, vedere Diritti di accesso per gli oggetti Access-Token.

Se Token è NULL, la funzione impedisce al thread di usare un token di rappresentazione.

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.

Commenti

Quando si usa la funzione SetThreadToken per rappresentare, è necessario disporre dei privilegi di rappresentazione e assicurarsi che la funzione SetThreadToken abbia esito positivo prima di chiamare la funzione RevertToSelf .

Requisiti

Requisito Valore
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 (include Windows.h)
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

Panoramica di Controllo di accesso

Funzioni Controllo di accesso di base

OpenThreadToken