CComContainedObject Sınıfı
Bu sınıf, sahip nesnesinin öğesine temsilci vererek IUnknown uygularIUnknown
.
Önemli
Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.
Sözdizimi
template<class Base>
class CComContainedObject : public Base
Parametreler
Temel
CComObjectRoot veya CComObjectRootEx'ten türetilen sınıfınız.
Üyeler
Ortak Oluşturucular
Ad | Tanım |
---|---|
CComContainedObject::CComContainedObject | Oluşturucu. Sahip nesnesinin IUnknown öğesine yönelik üye işaretçisini başlatır. |
CComContainedObject::~CComContainedObject | Yok edici. |
Genel Yöntemler
Ad | Tanım |
---|---|
CComContainedObject::AddRef | Sahip nesnesinde başvuru sayısını artırır. |
CComContainedObject::GetControllingUnknown | Sahip nesnesinin IUnknown öğesini alır. |
CComContainedObject::QueryInterface | Sahip nesnesinde istenen arabirimin işaretçisini alır. |
CComContainedObject::Release | Sahip nesnesinde başvuru sayısını azaltma. |
Açıklamalar
ATL, CComAggObject, CComPolyObject ve CComCachedTearOffObject sınıflarında kullanırCComContainedObject
. CComContainedObject
sahip nesnesinin öğesine temsilci vererek IUnknown uygularIUnknown
. (Sahip, bir toplamanın dış nesnesi veya bir kopma arabiriminin oluşturulduğu nesnedir.) CComContainedObject
aracılığıyla devralınan 's OuterQueryInterface
, OuterAddRef
ve OuterRelease
çağrılarını Base
çağırırCComObjectRootEx
.
Devralma Hiyerarşisi
Base
CComContainedObject
Gereksinimler
Üst bilgi: atlcom.h
CComContainedObject::AddRef
Sahip nesnesinde başvuru sayısını artırır.
STDMETHOD_(ULONG, AddRef)();
İade Değeri
Tanılama veya test için yararlı olabilecek bir değer.
CComContainedObject::CComContainedObject
Oluşturucu.
CComContainedObject(void* pv);
Parametreler
Pv
[in] Sahip nesnesinin IUnknown
.
Açıklamalar
Üye işaretçisini m_pOuterUnknown
(sınıf aracılığıyla devralınanBase
) bd olarak ayarlar.
CComContainedObject::~CComContainedObject
Yok edici.
~CComContainedObject();
Açıklamalar
Ayrılan tüm kaynakları serbesttir.
CComContainedObject::GetControllingUnknown
Sahip nesnesinin m_pOuterUnknown
IUnknown
öğesini tutan üye işaretçisini (Temel sınıf aracılığıyla devralınan) döndürür.
IUnknown* GetControllingUnknown();
İade Değeri
Sahip nesnesinin IUnknown
.
Açıklamalar
bu yöntem, DECLARE_GET_CONTROLLING_UNKNOWN makroyu bildirmişse Base
sanal olabilir.
CComContainedObject::QueryInterface
Sahip nesnesinde istenen arabirimin işaretçisini alır.
STDMETHOD(QueryInterface)(REFIID iid, void** ppvObject);
template <class Q>
HRESULT STDMETHODCALLTYPE QueryInterface(Q** pp);
Parametreler
ııd
[in] İstenen arabirimin tanımlayıcısı.
ppvObject
[out] iid ile tanımlanan arabirim işaretçisinin işaretçisi. Nesne bu arabirimi desteklemiyorsa, ppvObject NULL olarak ayarlanır.
S
[out] türüne Q
göre tanımlanan arabirim işaretçisinin işaretçisi. Nesne bu arabirimi desteklemiyorsa, pp null olarak ayarlanır.
İade Değeri
Standart bir HRESULT değeri.
CComContainedObject::Release
Sahip nesnesinde başvuru sayısını azaltma.
STDMETHOD_(ULONG, Release)();
İade Değeri
Hata ayıklama derlemelerinde, Release
tanılama veya test için yararlı olabilecek bir değer döndürür. Hata ayıklama olmayan derlemelerde Release
her zaman 0 döndürür.
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin