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 |