Método ISecurityCallContext::IsCallerInRole (comsvcs.h)
Determina se o chamador direto está na função especificada.
Sintaxe
HRESULT IsCallerInRole(
[in] BSTR bstrRole,
[out] VARIANT_BOOL *pfInRole
);
Parâmetros
[in] bstrRole
O nome da função.
[out] pfInRole
TRUE se o chamador 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.
Retornar valor
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 chamador 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.
IsCallerInRole só se aplica ao chamador direto do método em execução no momento. IsCallerInRole não se aplica a nenhum outro chamador na sequência de chamadas da qual o método atual foi chamado. No entanto, você pode obter informações sobre outros chamadores na sequência usando o método de propriedade get_Item para obter a propriedade Callers do objeto de contexto de chamada de segurança.
Como IsCallerInRole é TRUE quando a segurança baseada em função não está habilitada, é uma boa ideia chamar IsSecurityEnabled antes de chamar IsCallerInRole para garantir que IsCallerInRole retorne informações úteis.
Requisitos
Requisito | Valor |
---|---|
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 |