Función NtCompareTokens

La función NtCompareTokens compara dos tokens de acceso y determina si son equivalentes con respecto a una llamada a la función AccessCheck .

Sintaxis

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

Parámetros

FirstTokenHandle [in]

Identificador del primer token de acceso que se va a comparar. El token debe estar abierto para TOKEN_QUERY acceso.

SecondTokenHandle [in]

Identificador del segundo token de acceso que se va a comparar. El token debe estar abierto para TOKEN_QUERY acceso.

Igual [out]

Puntero a una variable que recibe un valor que indica si los tokens representados por los parámetros FirstTokenHandle y SecondTokenHandle son equivalentes.

Valor devuelto

Si la función se realiza correctamente, la función devuelve STATUS_SUCCESS.

Si se produce un error en la función, devuelve un código de error NTSTATUS .

Comentarios

Se considera que dos tokens de control de acceso son equivalentes si se cumplen todas las condiciones siguientes:

• Todos los identificadores de seguridad (SID) que están presentes en cualquiera de los tokens también están presentes en el otro token.
• Ninguno de los tokens o ambos están restringidos.
• Si ambos tokens están restringidos, todos los SID que están restringidos en un token también se restringen en el otro token.
• Todos los privilegios presentes en cualquiera de los tokens también están presentes en el otro token.

Esta función no tiene ningún archivo de encabezado o biblioteca de importación asociado; Debe llamarlo mediante las funciones LoadLibrary y GetProcAddress .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Ntseapi.h
Archivo DLL	Ntdll.dll