Funzione SetTokenInformation (securitybaseapi.h)

Articolo
03/01/2024

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