Compartir a través de

Función CheckTokenCapability (securitybaseapi.h)

  • Artículo

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