Fonction NtCompareTokens
La fonction NtCompareTokens compare deux jetons d’accès et détermine s’ils sont équivalents par rapport à un appel à la fonction AccessCheck .
Syntaxe
NTSTATUS NTAPI NtCompareTokens(
_In_ HANDLE FirstTokenHandle,
_In_ HANDLE SecondTokenHandle,
_Out_ PBOOLEAN Equal
);
Paramètres
-
FirstTokenHandle [in]
-
Handle du premier jeton d’accès à comparer. Le jeton doit être ouvert pour un accès TOKEN_QUERY .
-
SecondTokenHandle [in]
-
Handle du deuxième jeton d’accès à comparer. Le jeton doit être ouvert pour un accès TOKEN_QUERY .
-
Égal à [out]
-
Pointeur vers une variable qui reçoit une valeur qui indique si les jetons représentés par les paramètres FirstTokenHandle et SecondTokenHandle sont équivalents.
Valeur retournée
Si la fonction réussit, la fonction retourne STATUS_SUCCESS.
Si la fonction échoue, elle retourne un code d’erreur NTSTATUS .
Notes
Deux jetons de contrôle d’accès sont considérés comme équivalents si toutes les conditions suivantes sont remplies :
- Chaque identificateur de sécurité (SID) présent dans l’un des deux jetons est également présent dans l’autre jeton.
- Ni les deux jetons ne sont restreints.
- Si les deux jetons sont restreints, chaque SID restreint dans un jeton est également limité dans l’autre jeton.
- Chaque privilège présent dans l’un des deux jetons est également présent dans l’autre jeton.
Cette fonction n’a pas de bibliothèque d’importation ou de fichier d’en-tête associé ; vous devez l’appeler à l’aide des fonctions LoadLibrary et GetProcAddress .
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| En-tête |
|
| DLL |
|