Compartilhar via


Função CheckTokenMembershipEx (securitybaseapi.h)

A função CheckTokenMembershipEx determina se o SID especificado está habilitado no token especificado.

Sintaxe

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

Parâmetros

[in, optional] TokenHandle

Um identificador para um token de acesso. Se presente, esse token será verificado para o SID. Se não estiver presente, o token efetivo atual será usado. Deve ser um token de representação.

[in] SidToCheck

Um ponteiro para uma estrutura SID. A função verifica a presença desse SID na presença do token.

[in] Flags

Sinalizadores que afetam o comportamento da função. Atualmente, o único sinalizador válido é CTMF_INCLUDE_APPCONTAINER que permite que os contêineres de aplicativo passem a chamada desde que os outros requisitos do token sejam atendidos, como o grupo especificado está presente e habilitado.

[out] IsMember

TRUE se o SID estiver habilitado no token; caso contrário, FALSE.

Valor retornado

Se a função for bem-sucedida, ela retornará TRUE.

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

Requisitos

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