Partage via

IObjectWithSiteImpl, classe

  • Article

Cette classe fournit des méthodes permettant à un objet de communiquer avec son site.

Syntaxe

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite

Paramètres

T
Votre classe, dérivée de IObjectWithSiteImpl.

Membres

Méthodes publiques

Nom Description
IObjectWithSiteImpl ::GetSite Interroge le site pour un pointeur d’interface.
IObjectWithSiteImpl ::SetChildSite Fournit l’objet avec le pointeur du IUnknown site.
IObjectWithSiteImpl ::SetSite Fournit l’objet avec le pointeur du IUnknown site.

Membres de données publics

Nom Description
IObjectWithSiteImpl ::m_spUnkSite Gère le pointeur du IUnknown site.

Notes

L’interface IObjectWithSite permet à un objet de communiquer avec son site. La classe IObjectWithSiteImpl fournit une implémentation par défaut de cette interface et implémente en envoyant des IUnknown informations à l’appareil de vidage dans les builds de débogage.

IObjectWithSiteImpl spécifie deux méthodes. Le client appelle SetSited’abord , en passant le pointeur du IUnknown site. Ce pointeur est stocké dans l’objet et peut être récupéré ultérieurement via un appel à GetSite.

En règle générale, vous dérivez votre classe IObjectWithSiteImpl lorsque vous créez un objet qui n’est pas un contrôle. Pour les contrôles, dérivez votre classe d’IOleObjectImpl, qui fournit également un pointeur de site. Ne dérivez pas votre classe des deux IObjectWithSiteImpl et IOleObjectImpl.

Hiérarchie d'héritage

IObjectWithSite

IObjectWithSiteImpl

Spécifications

En-tête : atlcom.h

IObjectWithSiteImpl ::GetSite

Interroge le site d’un pointeur vers l’interface identifiée par riid.

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

Notes

Si le site prend en charge cette interface, le pointeur est retourné via ppvSite. Sinon, ppvSite la valeur NULL est définie sur NULL.

Consultez IObjectWithSite ::GetSite dans le Kit de développement logiciel (SDK) Windows.

IObjectWithSiteImpl ::m_spUnkSite

Gère le pointeur du IUnknown site.

CComPtr<IUnknown> m_spUnkSite;

Notes

m_spUnkSite reçoit initialement ce pointeur via un appel à SetSite.

IObjectWithSiteImpl ::SetChildSite

Fournit l’objet avec le pointeur du IUnknown site.

HRESULT SetChildSite(IUnknown* pUnkSite);

Paramètres

pUnkSite
[in] Pointeur vers le pointeur d’interface IUnknown du site gérant cet objet. Si la valeur est NULL, l’objet doit appeler IUnknown::Release n’importe quel site existant auquel point l’objet ne connaît plus son site.

Valeur de retour

Retourne S_OK.

IObjectWithSiteImpl ::SetSite

Fournit l’objet avec le pointeur du IUnknown site.

STDMETHOD(SetSite)(IUnknown* pUnkSite);

Notes

Consultez IObjectWithSite ::SetSite dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

Vue d’ensemble de la classe