Compartilhar via


Método IGetSecurityCallContext::GetSecurityCallContext (comsvcs.h)

Recupera uma referência a um objeto criado da classe SecurityCallContext associada à chamada atual.

Em vez de usar esse método, os desenvolvedores do C++ devem usar a função CoGetCallContext , fornecendo IID_ISecurityCallContext para o parâmetro riid .

Sintaxe

HRESULT GetSecurityCallContext(
  [out] ISecurityCallContext **ppObject
);

Parâmetros

[out] ppObject

Uma referência a ISecurityCallContext no contexto do objeto.

Valor retornado

Esse método pode retornar os valores de retorno 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
O método foi concluído com sucesso.
CONTEXT_E_NOCONTEXT
O objeto atual não tem um contexto associado a ele porque o componente não foi importado para um aplicativo ou o objeto não foi criado com um dos métodos CreateInstance COM+. Esse erro também será retornado se o método GetObjectContext tiver sido chamado de um construtor ou de um método IUnknown.

Comentários

Com o contexto de chamada de segurança de um objeto, você pode recuperar itens na coleção de contexto de chamada de segurança, como o nível mínimo de autenticação, o chamador direto, o chamador original, a cadeia de chamadores e o número de chamadores. Você também pode chamar os métodos IsSecurityEnabled e IsCallerInRole para garantir que uma seção específica do código seja executada. No entanto, você só poderá chamar esses métodos se a segurança baseada em função estiver habilitada e se o chamador direto for membro de uma função especificada.

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

Contextos com+ e modelos de threading

Cogetcallcontext

IGetSecurityCallContext

Isecuritycallcontext