Função CheckTokenCapability (securitybaseapi.h)

Artigo
08/25/2023

A função CheckTokenCapability verifica os recursos de um determinado token.

Sintaxe

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

Parâmetros

[in, optional] TokenHandle

Um identificador para um token de acesso. O identificador deve ter TOKEN_QUERY acesso ao token. O token deve ser um token de representação.

Se TokenHandle for NULL, CheckTokenCapability usará o token de representação do thread de chamada. Se o thread não estiver representando, a função duplicará o token primário do thread para criar um token de representação.

[in] CapabilitySidToCheck

Um ponteiro para uma estrutura sid de funcionalidade. A função CheckTokenCapability verifica os recursos desse token de acesso.

[out] HasCapability

Recebe os resultados do marcar. Se o token de acesso tiver a funcionalidade, ele retornará TRUE, caso contrário, retornará FALSE.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError

Requisitos


Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Kernel32.dll

Compartilhar via