Função CoGetObjectContext (combaseapi.h)

  • Artigo

Retorna o contexto do objeto atual.

Sintaxe

HRESULT CoGetObjectContext(
  [in]  REFIID riid,
  [out] LPVOID *ppv
);

Parâmetros

[in] riid

Uma referência à ID de uma interface implementada no objeto de contexto.

Para objetos em execução em aplicativos COM, IID_IComThreadingInfo, IID_IContext e IID_IContextCallback estão disponíveis.

Para objetos em execução em aplicativos COM+, IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo e IID_IContextState estão disponíveis.

[out] ppv

O endereço de um ponteiro para a interface especificada por riid no objeto de contexto.

Retornar valor

Essa função pode retornar os valores retornados padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O contexto do objeto foi recuperado com êxito.
E_NOINTERFACE
 A interface solicitada não estava disponível.
CO_E_NOTINITIALIZED
 Antes que essa função possa ser chamada, a função CoInitializeEx deve ser chamada no thread atual.

Comentários

CoGetObjectContext recupera o contexto do objeto do qual ele é chamado e retorna um ponteiro para uma interface que pode ser usada para manipular propriedades de contexto. As propriedades de contexto são usadas para fornecer serviços para componentes configurados em execução em aplicativos COM+.

Para componentes em execução em aplicativos COM, há suporte para as seguintes interfaces para acessar propriedades de contexto: IComThreadingInfo, IContext e IContextCallback.

Para componentes em execução em aplicativos COM+, há suporte para as seguintes interfaces para acessar propriedades de contexto: IObjectContext, IObjectContextActivity, IObjectContextInfo e IContextState.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

Contextos e modelos de threading