Clase CComObjectGlobal
Esta clase administra un recuento de referencias del módulo que contiene el objeto Base.
Sintaxis
template<class Base>
class CComObjectGlobal : public Base
Parámetros
Base
La clase, que se deriva de CComObjectRoot o CComObjectRootEx, así como de cualquier otra interfaz que desee admitir en el objeto.
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CComObjectGlobal::CComObjectGlobal | Constructor . |
| CComObjectGlobal::~CComObjectGlobal | El destructor . |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CComObjectGlobal::AddRef | Implementa un AddRef global. |
| CComObjectGlobal::QueryInterface | Implementa un QueryInterface global. |
| CComObjectGlobal::Release | Implementa un Release global. |
Miembros de datos públicos
| Nombre | Descripción |
|---|---|
| CComObjectGlobal::m_hResFinalConstruct | Contiene el valor HRESULT devuelto durante la construcción del objeto CComObjectGlobal. |
Comentarios
CComObjectGlobal administra un recuento de referencias del módulo que contiene el objeto Base. CComObjectGlobal garantiza que el objeto no se eliminará siempre que el módulo no se libere. El objeto solo se eliminará cuando el recuento de referencias de todo el módulo vaya a cero.
Por ejemplo, con el uso de CComObjectGlobal, un generador de clases puede contener un objeto global común compartido por todos sus clientes.
Jerarquía de herencia
Base
CComObjectGlobal
Requisitos
Encabezado: atlcom.h
CComObjectGlobal::AddRef
Incrementa el recuento de referencias del objeto en 1.
STDMETHOD_(ULONG, AddRef)();
Valor devuelto
Valor que puede ser útil para los diagnósticos y las pruebas.
Comentarios
De manera predeterminada, AddRef llama a _Module::Lock, donde _Module es la instancia global de CComModule o una clase derivada de ella.
CComObjectGlobal::CComObjectGlobal
Constructor . Llama a FinalConstruct y, después, establece m_hResFinalConstruct en el valor HRESULT devuelto por FinalConstruct.
CComObjectGlobal(void* = NULL));
Comentarios
Si no ha derivado la clase base de CComObjectRoot, debe proporcionar su propio método FinalConstruct. El destructor llama a FinalRelease.
CComObjectGlobal::~CComObjectGlobal
El destructor .
CComObjectGlobal();
Comentarios
Libera todos los recursos asignados y llama a FinalRelease.
CComObjectGlobal::m_hResFinalConstruct
Contiene el valor HRESULT que se devuelve al llamar a FinalConstruct durante la construcción del objeto CComObjectGlobal.
HRESULT m_hResFinalConstruct;
CComObjectGlobal::QueryInterface
Recupera un puntero dirigido al puntero de la interfaz solicitada.
STDMETHOD(QueryInterface)(REFIID iid, void** ppvObject);
Parámetros
iid
[in] GUID de la interfaz que se solicita.
ppvObject
[out] Puntero dirigido al puntero de interfaz identificado por iid, o a NULL si la interfaz no se encuentra.
Valor devuelto
Valor HRESULT estándar.
Comentarios
QueryInterface solo administra interfaces de la tabla de asignación COM.
CComObjectGlobal::Release
Decrementa en uno el recuento de referencias del objeto.
STDMETHOD_(ULONG, Release)();
Valor devuelto
En las compilaciones de depuración, Release devuelve un valor que puede ser útil para los diagnósticos y las pruebas. En compilaciones que no son de depuración, Release siempre devuelve 0.
Comentarios
De manera predeterminada, Release llama a _Module::Unlock, donde _Module es la instancia global de CComModule o una clase derivada de ella.
Consulte también
CComObjectStack (clase)
CComAggObject (clase)
CComObject (clase)
Información general sobre la clase