NtCompareTokens fonction)
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 [ dans]
-
Handle vers le premier jeton d’accès à comparer. Le jeton doit être ouvert pour l’accès à la _ requête de jeton .
-
SecondTokenHandle [ dans]
-
Handle vers le deuxième jeton d’accès à comparer. Le jeton doit être ouvert pour l’accès à la _ requête de jeton .
-
Égal [ à à]
-
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 l’état _ Success.
Si la fonction échoue, elle retourne un code d’erreur NTSTATUS .
Remarques
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) qui est présent dans l’un des jetons est également présent dans l’autre jeton.
- Aucun ou les deux jetons ne sont limités.
- Si les deux jetons sont restreints, chaque SID qui est limité 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 .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| En-tête |
|
| DLL |
|