Função NtCompareTokens
A função NtCompareTokens compara dois tokens de acesso e determina se eles são equivalentes em relação a uma chamada para a função AccessCheck .
Sintaxe
NTSTATUS NTAPI NtCompareTokens(
_In_ HANDLE FirstTokenHandle,
_In_ HANDLE SecondTokenHandle,
_Out_ PBOOLEAN Equal
);
Parâmetros
-
FirstTokenHandle [in]
-
Um identificador para o primeiro token de acesso a ser comparado. O token deve estar aberto para acesso TOKEN_QUERY .
-
SecondTokenHandle [in]
-
Um identificador para o segundo token de acesso a ser comparado. O token deve estar aberto para acesso TOKEN_QUERY .
-
Igual a [out]
-
Um ponteiro para uma variável que recebe um valor que indica se os tokens representados pelos parâmetros FirstTokenHandle e SecondTokenHandle são equivalentes.
Valor retornado
Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.
Se a função falhar, ela retornará um código de erro NTSTATUS .
Comentários
Dois tokens de controle de acesso serão considerados equivalentes se todas as seguintes condições forem verdadeiras:
- Cada SID ( identificador de segurança ) presente em qualquer token também está presente no outro token.
- Nenhum ou ambos os tokens são restritos.
- Se ambos os tokens forem restritos, cada SID restrito em um token também será restrito no outro token.
- Todos os privilégios presentes em qualquer token também estão presentes no outro token.
Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|