Funzione NtCompareTokens

Articolo
06/13/2023

La funzione NtCompareTokens confronta due token di accesso e determina se sono equivalenti rispetto a una chiamata alla funzione AccessCheck .

Sintassi

NTSTATUS NTAPI NtCompareTokens(
  _In_  HANDLE   FirstTokenHandle,
  _In_  HANDLE   SecondTokenHandle,
  _Out_ PBOOLEAN Equal
);

Parametri

FirstTokenHandle [in]: Handle per il primo token di accesso da confrontare. Il token deve essere aperto per l'accesso TOKEN_QUERY .
SecondTokenHandle [in]: Handle per il secondo token di accesso da confrontare. Il token deve essere aperto per l'accesso TOKEN_QUERY .
Uguale a [out]: Puntatore a una variabile che riceve un valore che indica se i token rappresentati dai parametri FirstTokenHandle e SecondTokenHandle sono equivalenti.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce STATUS_SUCCESS.

Se la funzione non riesce, restituisce un codice di errore NTSTATUS .

Commenti

Due token di controllo di accesso sono considerati equivalenti se tutte le condizioni seguenti sono vere:

Ogni IDENTIFICATORe di sicurezza (SID) presente in entrambi i token è presente anche nell'altro token.
Nessuno o entrambi i token sono limitati.
Se entrambi i token sono limitati, anche ogni SID con restrizioni in un token viene limitato nell'altro token.
Ogni privilegio presente in entrambi i token è presente anche nell'altro token.

Questa funzione non ha una libreria di importazione o un file di intestazione associato; è necessario chiamarlo usando le funzioni LoadLibrary e GetProcAddress .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Ntseapi.h
DLL	Ntdll.dll

Condividi tramite