Método ISecurityCallContext::IsUserInRole (comsvcs.h)

  • Artigo

Determina se o usuário especificado está na função especificada.

Sintaxe

HRESULT IsUserInRole(
  [in]  VARIANT      *pUser,
  [in]  BSTR         bstrRole,
  [out] VARIANT_BOOL *pfInRole
);

Parâmetros

[in] pUser

Um ponteiro para o valor que contém a ID de Usuário do usuário cuja associação de função deve ser verificada. Se você pretende passar o SID (identificador de segurança) para IsUserInRole, esse parâmetro deve atender aos seguintes requisitos: V_VT(pUser) == (VT_ARRAY|VT_UI1) && V_ARRAY(pUser)->cDims == 1.

[in] bstrRole

O nome da função.

[out] pfInRole

TRUE se o usuário estiver na função especificada; FALSE se não estiver. Se a função especificada não estiver definida para o aplicativo, FALSE será retornado. Esse parâmetro será definido como TRUE se a segurança baseada em função não estiver habilitada.

Valor retornado

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 A função especificada no parâmetro bstrRole é uma função reconhecida e o resultado booliano retornado no parâmetro pfIsInRole indica se o usuário está nessa função.
CONTEXT_E_ROLENOTFOUND
 A função especificada no parâmetro bstrRole não existe.

Comentários

Use esse método para limitar o acesso a seções de código que não devem ser executadas, a menos que o chamador seja membro da função especificada. Grupos e usuários do Windows são atribuídos às funções de um aplicativo usando a ferramenta de administração dos Serviços de Componentes. Para obter mais informações sobre funções, consulte Segurança baseada em função.

Como IsUserInRole é TRUE quando a segurança baseada em função não está habilitada, é uma boa ideia chamar IsSecurityEnabled antes de chamar IsUserInRole para garantir que IsUserInRole retorne informações úteis.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comsvcs.h

Confira também

Isecuritycallcontext

Segurança de componente programática