Funzione GetTokenInformation (securitybaseapi.h)

Articolo
03/15/2023

La funzione GetTokenInformation recupera un tipo specificato di informazioni su un token di accesso. Per ottenere le informazioni, il processo chiamante deve disporre dei diritti di accesso appropriati.

Per determinare se un utente è membro di un gruppo specifico, usare la funzione CheckTokenMembership . Per determinare l'appartenenza al gruppo per i token del contenitore di app, usare la funzione CheckTokenMembershipEx .

Sintassi

BOOL GetTokenInformation(
  [in]            HANDLE                  TokenHandle,
  [in]            TOKEN_INFORMATION_CLASS TokenInformationClass,
  [out, optional] LPVOID                  TokenInformation,
  [in]            DWORD                   TokenInformationLength,
  [out]           PDWORD                  ReturnLength
);

Parametri

[in] TokenHandle

Handle per un token di accesso da cui vengono recuperate le informazioni. Se TokenInformationClass specifica TokenSource, l'handle deve avere accesso TOKEN_QUERY_SOURCE. Per tutti gli altri valori TokenInformationClass , l'handle deve avere accesso TOKEN_QUERY.

[in] TokenInformationClass

Specifica un valore dal tipo enumerato TOKEN_INFORMATION_CLASS per identificare il tipo di informazioni recuperate dalla funzione. Tutti i chiamanti che controllano TokenIsAppContainer e hanno restituito 0 devono anche verificare che il token del chiamante non sia un token di rappresentazione a livello di identificazione. Se il token corrente non è un contenitore di app ma è un token a livello di identità, è necessario restituire AccessDenied.

[out, optional] TokenInformation

Puntatore a un buffer che la funzione riempie con le informazioni richieste. La struttura inserita in questo buffer dipende dal tipo di informazioni specificato dal parametro TokenInformationClass .

[in] TokenInformationLength

Specifica le dimensioni, in byte, del buffer a cui punta il parametro TokenInformation . Se TokenInformation è NULL, questo parametro deve essere zero.

[out] ReturnLength

Puntatore a una variabile che riceve il numero di byte necessari per il buffer a cui punta il parametro TokenInformation . Se questo valore è maggiore del valore specificato nel parametro TokenInformationLength , la funzione ha esito negativo e non archivia dati nel buffer.

Se il valore del parametro TokenInformationClass è TokenDefaultDacl e il token non ha daCL predefinito, la funzione imposta la variabile a cui fa riferimento ReturnLength su sizeof(TOKEN_DEFAULT_DACL) e imposta il membro DefaultDacl della struttura TOKEN_DEFAULT_DACL su NULL.

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.

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