CComObjectGlobal – třída

Tato třída spravuje počet odkazů na modul obsahující objekt Base .

Syntaxe

template<class Base>
class CComObjectGlobal : public Base

Parametry

Základna
Třída odvozená z CComObjectRoot nebo CComObjectRootEx, stejně jako z jakéhokoli jiného rozhraní, které chcete podporovat na objektu.

Členové

Veřejné konstruktory

Název	Popis
CComObjectGlobal::CComObjectGlobal	Konstruktor
CComObjectGlobal::~CComObjectGlobal	Destruktor.

Veřejné metody

Název	Popis
CComObjectGlobal::AddRef	Implementuje globální AddRef.
CComObjectGlobal::QueryInterface	Implementuje globální QueryInterface.
CComObjectGlobal::Release	Implementuje globální Release.

Veřejné datové členy

Název	Popis
CComObjectGlobal::m_hResFinalConstruct	Obsahuje HODNOTU HRESULT vrácenou během výstavby objektu CComObjectGlobal .

Poznámky

CComObjectGlobal spravuje počet odkazů na modul obsahující váš Base objekt. CComObjectGlobal zajistí, že se objekt neodstraní, dokud se modul nevyvolá. Objekt se odebere jenom v případech, kdy počet odkazů na celý modul přejde na nulu.

Například použití CComObjectGlobal, třída továrna může obsahovat společný globální objekt, který je sdílen všemi jeho klienty.

Hierarchie dědičnosti

Base

CComObjectGlobal

Požadavky

Hlavička: atlcom.h

CComObjectGlobal::AddRef

Zvýší počet odkazů objektu o 1.

STDMETHOD_(ULONG, AddRef)();

Návratová hodnota

Hodnota, která může být užitečná pro diagnostiku a testování.

Poznámky

Ve výchozím nastavení AddRef volání _Module::Lock, kde _Module je globální instance CComModule nebo třídy odvozené z ní.

CComObjectGlobal::CComObjectGlobal

Konstruktor Volání FinalConstruct a poté nastaví m_hResFinalConstruct na vrácený HRESULT FinalConstruct.

CComObjectGlobal(void* = NULL));

Poznámky

Pokud jste základní třídu neodvozovali z CComObjectRoot, musíte zadat vlastní FinalConstruct metodu. Destruktor volá FinalRelease.

CComObjectGlobal::~CComObjectGlobal

Destruktor.

CComObjectGlobal();

Poznámky

Uvolní všechny přidělené prostředky a zavolá FinalRelease.

CComObjectGlobal::m_hResFinalConstruct

Obsahuje HRESULT volání FinalConstruct během vytváření objektu CComObjectGlobal .

HRESULT m_hResFinalConstruct;

CComObjectGlobal::QueryInterface

Načte ukazatel na požadovaný ukazatel rozhraní.

STDMETHOD(QueryInterface)(REFIID iid, void** ppvObject);

Parametry

iid
[v] Identifikátor GUID požadovaného rozhraní.

ppvObject
[ven] Ukazatel na ukazatel rozhraní identifikovaný parametrem iid nebo NULL, pokud rozhraní nebylo nalezeno.

Návratová hodnota

Standardní hodnota HRESULT.

Poznámky

QueryInterface zpracovává pouze rozhraní v tabulce mapování modelu COM.

CComObjectGlobal::Release

Sníží počet odkazů objektu o 1.

STDMETHOD_(ULONG, Release)();

Návratová hodnota

V buildech ladění vrátí hodnotu, Release která může být užitečná pro diagnostiku a testování. V neladit sestavení vždy Release vrátí hodnotu 0.

Poznámky

Ve výchozím nastavení Release volání _Module::Unlock, kde _Module je globální instance CComModule nebo třídy odvozené z ní.

Viz také

CComObjectStack – třída
CComAggObject – třída
CComObject – třída
Přehled třídy