Teilen über


IObjectWithSiteImpl-Klasse

Diese Klasse stellt Methoden bereit, mit denen ein Objekt mit seiner Website kommunizieren kann.

Syntax

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite

Parameter

T
Ihre Klasse, abgeleitet von IObjectWithSiteImpl.

Member

Öffentliche Methoden

Name Beschreibung
IObjectWithSiteImpl::GetSite Fragt die Website nach einem Schnittstellenzeiger ab.
IObjectWithSiteImpl::SetChildSite Stellt das Objekt mit dem Zeiger der Website IUnknown bereit.
IObjectWithSiteImpl::SetSite Stellt das Objekt mit dem Zeiger der Website IUnknown bereit.

Öffentliche Datenmember

Name Beschreibung
IObjectWithSiteImpl::m_spUnkSite Verwaltet den Zeiger der Website IUnknown .

Hinweise

Die IObjectWithSite-Schnittstelle ermöglicht es einem Objekt, mit seiner Website zu kommunizieren. Klasse IObjectWithSiteImpl stellt eine Standardimplementierung dieser Schnittstelle bereit und implementiert, indem Informationen in Debugbuilds IUnknown an das Speicherabbildgerät gesendet werden.

IObjectWithSiteImpl Gibt zwei Methoden an. Der Client ruft zuerst auf SetSite, und übergibt den Zeiger der Website IUnknown . Dieser Zeiger wird innerhalb des Objekts gespeichert und kann später über einen Aufruf GetSiteabgerufen werden.

In der Regel leiten Sie die Klasse ab IObjectWithSiteImpl , wenn Sie ein Objekt erstellen, das kein Steuerelement ist. Leiten Sie ihre Klasse für Steuerelemente von IOleObjectImpl ab, das auch einen Websitezeiger bereitstellt. Leiten Sie Ihren Kurs nicht von beiden IObjectWithSiteImpl und IOleObjectImplab.

Vererbungshierarchie

IObjectWithSite

IObjectWithSiteImpl

Anforderungen

Kopfzeile: atlcom.h

IObjectWithSiteImpl::GetSite

Fragt die Website nach einem Zeiger auf die Schnittstelle ab, die von riid.

STDMETHOD(GetSite)(
    REFIID riid,
    void** ppvSite);

Hinweise

Wenn die Website diese Schnittstelle unterstützt, wird der Zeiger über ppvSite. ppvSite Andernfalls wird dieser Wert auf NULL festgelegt.

Siehe "IObjectWithSite::GetSite " im Windows SDK.

IObjectWithSiteImpl::m_spUnkSite

Verwaltet den Zeiger der Website IUnknown .

CComPtr<IUnknown> m_spUnkSite;

Hinweise

m_spUnkSite Empfängt diesen Zeiger zunächst über einen Aufruf von SetSite.

IObjectWithSiteImpl::SetChildSite

Stellt das Objekt mit dem Zeiger der Website IUnknown bereit.

HRESULT SetChildSite(IUnknown* pUnkSite);

Parameter

pUnkSite
[in] Zeigen Sie auf den IUnknown Schnittstellenzeiger der Website, die dieses Objekt verwaltet. Wenn NULL, sollte das Objekt an einer vorhandenen Website aufrufen IUnknown::Release , an der das Objekt seine Website nicht mehr kennt.

Rückgabewert

Gibt S_OK zurück.

IObjectWithSiteImpl::SetSite

Stellt das Objekt mit dem Zeiger der Website IUnknown bereit.

STDMETHOD(SetSite)(IUnknown* pUnkSite);

Hinweise

Siehe "IObjectWithSite::SetSite " im Windows SDK.

Siehe auch

Klassenübersicht