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
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 chamador 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.

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

Confira também

Isecuritycallcontext

Segurança de componente programática

Segurança baseada em Função