CComObjectGlobal-Klasse
Diese Klasse verwaltet eine Referenzanzahl für das Modul, das Ihr Base Objekt enthält.
Syntax
template<class Base>
class CComObjectGlobal : public Base
Parameter
Bemessungsgrundlage
Ihre Von CComObjectRoot oder CComObjectRootEx abgeleitete Klasse sowie von einer anderen Schnittstelle, die Sie für das Objekt unterstützen möchten.
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CComObjectGlobal::CComObjectGlobal | Der Konstruktor. |
| CComObjectGlobal::~CComObjectGlobal | Der Destruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CComObjectGlobal::AddRef | Implementiert eine globale AddRef. |
| CComObjectGlobal::QueryInterface | Implementiert eine globale QueryInterface. |
| CComObjectGlobal::Release | Implementiert eine globale Release. |
Öffentliche Datenmember
| Name | Beschreibung |
|---|---|
| CComObjectGlobal::m_hResFinalConstruct | Enthält das HRESULT, das beim Erstellen des CComObjectGlobal Objekts zurückgegeben wird. |
Hinweise
CComObjectGlobal verwaltet eine Referenzanzahl für das Modul, das Ihr Base Objekt enthält. CComObjectGlobal stellt sicher, dass Das Objekt nicht gelöscht wird, solange das Modul nicht freigegeben wird. Ihr Objekt wird nur entfernt, wenn die Bezugsanzahl des gesamten Moduls auf Null gesetzt wird.
Beispielsweise CComObjectGlobalkann eine Klassenfactory ein gemeinsames globales Objekt enthalten, das von allen Clients gemeinsam genutzt wird.
Vererbungshierarchie
Base
CComObjectGlobal
Anforderungen
Kopfzeile: atlcom.h
CComObjectGlobal::AddRef
Erhöht die Referenzanzahl des Objekts um 1.
STDMETHOD_(ULONG, AddRef)();
Rückgabewert
Ein Wert, der für Diagnose und Tests nützlich sein kann.
Hinweise
Ruft standardmäßig auf_Module::Lock, AddRef wobei _Module es sich um die globale Instanz von CComModule oder eine von ihr abgeleitete Klasse handelt.
CComObjectGlobal::CComObjectGlobal
Der Konstruktor. Ruft FinalConstruct auf und legt dann m_hResFinalConstruct auf die HRESULT zurückgegeben von FinalConstruct.
CComObjectGlobal(void* = NULL));
Hinweise
Wenn Sie Ihre Basisklasse nicht von CComObjectRoot abgeleitet haben, müssen Sie ihre eigene FinalConstruct Methode angeben. Der Destruktor ruft FinalRelease auf.
CComObjectGlobal::~CComObjectGlobal
Der Destruktor.
CComObjectGlobal();
Hinweise
Gibt alle zugeordneten Ressourcen frei und ruft FinalRelease auf.
CComObjectGlobal::m_hResFinalConstruct
Enthält das HRESULT,das beim Erstellen des CComObjectGlobal Objekts aufgerufen FinalConstruct wird.
HRESULT m_hResFinalConstruct;
CComObjectGlobal::QueryInterface
Ruft einen Zeiger auf den angeforderten Schnittstellenzeiger ab.
STDMETHOD(QueryInterface)(REFIID iid, void** ppvObject);
Parameter
iid
[in] Die GUID der angeforderten Schnittstelle.
ppvObject
[out] Ein Zeiger auf den von iid identifizierten Schnittstellenzeiger oder NULL, wenn die Schnittstelle nicht gefunden wird.
Rückgabewert
Ein HRESULT-Standardwert.
Hinweise
QueryInterface behandelt nur Schnittstellen in der COM-Zuordnungstabelle.
CComObjectGlobal::Release
Erhöht die Referenzanzahl des Objekts um 1.
STDMETHOD_(ULONG, Release)();
Rückgabewert
Gibt in Debugbuilds einen Wert zurück, Release der für Diagnose und Tests nützlich sein kann. Gibt in Nicht-Debug-Builds Release immer "0" zurück.
Hinweise
Ruft standardmäßig auf_Module::Unlock, Release wobei _Module es sich um die globale Instanz von CComModule oder eine von ihr abgeleitete Klasse handelt.
Siehe auch
CComObjectStack-Klasse
CComAggObject-Klasse
CComObject-Klasse
Klassenübersicht