Compartir a través de

Función CoGetObjectContext (combaseapi.h)

  • Artículo

Devuelve el contexto del objeto actual.

Sintaxis

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

Parámetros

[in] riid

Referencia al identificador de una interfaz que se implementa en el objeto de contexto.

En el caso de los objetos que se ejecutan en aplicaciones COM, IID_IComThreadingInfo, IID_IContext y IID_IContextCallback están disponibles.

Para los objetos que se ejecutan en aplicaciones COM+, IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo y IID_IContextState están disponibles.

[out] ppv

Dirección de un puntero a la interfaz especificada por riid en el objeto de contexto.

Valor devuelto

Esta función puede devolver los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los valores siguientes.

Código devuelto Descripción
S_OK
 El contexto del objeto se recuperó correctamente.
E_NOINTERFACE
 La interfaz solicitada no estaba disponible.
CO_E_NOTINITIALIZED
 Para poder llamar a esta función, se debe llamar a la función CoInitializeEx en el subproceso actual.

Comentarios

CoGetObjectContext recupera el contexto del objeto desde el que se llama y devuelve un puntero a una interfaz que se puede usar para manipular las propiedades de contexto. Las propiedades de contexto se usan para proporcionar servicios a componentes configurados que se ejecutan en aplicaciones COM+.

En el caso de los componentes que se ejecutan en aplicaciones COM, se admiten las siguientes interfaces para acceder a las propiedades de contexto: IComThreadingInfo, IContext e IContextCallback.

En el caso de los componentes que se ejecutan en aplicaciones COM+, se admiten las siguientes interfaces para acceder a las propiedades de contexto: IObjectContext, IObjectContextActivity, IObjectContextInfo e IContextState.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado combaseapi.h (incluya Objbase.h)
Library Ole32.lib
Archivo DLL Ole32.dll

Consulte también

Contextos y modelos de subprocesos