Función CheckTokenCapability (securitybaseapi.h)

La función CheckTokenCapability comprueba las funciones de un token determinado.

Sintaxis

BOOL CheckTokenCapability(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   CapabilitySidToCheck,
  [out]          PBOOL  HasCapability
);

Parámetros

[in, optional] TokenHandle

Identificador de un token de acceso. El identificador debe tener TOKEN_QUERY acceso al token. El token debe ser un token de suplantación.

Si TokenHandle es NULL, CheckTokenCapability usa el token de suplantación del subproceso que realiza la llamada. Si el subproceso no suplanta, la función duplica el token principal del subproceso para crear un token de suplantación.

[in] CapabilitySidToCheck

Puntero a una estructura de SID de funcionalidad. La función CheckTokenCapability comprueba las funcionalidades de este token de acceso.

[out] HasCapability

Recibe los resultados de la comprobación. Si el token de acceso tiene la funcionalidad , devuelve TRUE; de lo contrario, devuelve FALSE.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Kernel32.dll