Método ISecurityCallContext::IsUserInRole (comsvcs.h)
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 |
|---|---|
|
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. |
|
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 |