IObjectWithSite ::SetSite, méthode (ocidl.h)

Permet à un conteneur de passer un objet un pointeur vers l’interface de son site.

Syntaxe

HRESULT SetSite(
  [in] IUnknown *pUnkSite
);

Paramètres

[in] pUnkSite

Pointeur vers le pointeur d’interface IUnknown du site qui gère cet objet. Si la valeur est NULL, l’objet doit appeler Release sur n’importe quel site existant, auquel cas l’objet ne connaît plus son site.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite.

Remarques

L’objet doit conserver ce pointeur, en appelant IUnknown ::AddRef . Si l’objet a déjà un site, il doit appeler le IUnknown ::Release de ce site existant, enregistrer le nouveau pointeur de site et appeler le IUnknown ::AddRef du nouveau site.

E_NOTIMPL n’est pas autorisé. Sans implémentation de la méthode SetSite , l’interface IObjectWithSite n’est pas nécessaire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IObjectWithSite