Condividi tramite


Funzione SetTokenInformation (securitybaseapi.h)

La funzione SetTokenInformation imposta vari tipi di informazioni per un token di accesso specificato. Le informazioni impostate da questa funzione sostituisce le informazioni esistenti. Il processo di chiamata deve disporre dei diritti di accesso appropriati per impostare le informazioni.

Sintassi

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

Parametri

[in] TokenHandle

Handle per il token di accesso per cui devono essere impostate le informazioni.

[in] TokenInformationClass

Valore del tipo enumerato TOKEN_INFORMATION_CLASS che identifica il tipo di informazioni dei set di funzioni. I valori validi di TOKEN_INFORMATION_CLASS sono descritti nel parametro TokenInformation .

[in] TokenInformation

Puntatore a un buffer contenente le informazioni impostate nel token di accesso. La struttura di questo buffer dipende dal tipo di informazioni specificate dal parametro TokenInformationClass .

[in] TokenInformationLength

Specifica la lunghezza, in byte, del buffer a cui fa riferimento TokenInformation.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per impostare le informazioni sui privilegi, un'applicazione può chiamare la funzione AdjustTokenPrivileges . Per impostare i gruppi di un token, un'applicazione può chiamare la funzione AdjustTokenGroups .

Le informazioni sul tipo di token possono essere impostate solo quando viene creato un token di accesso.

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

Vedi anche

Panoramica Controllo di accesso

AdjustTokenGroups

RegolaTokenPrivileges

Funzioni di base Controllo di accesso

GetTokenInformation

OpenProcessToken

OpenThreadToken

TOKEN_DEFAULT_DACL

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP