IObjectWithSite::SetSite-Methode (ocidl.h)
Ermöglicht es einem Container, einem Objekt einen Zeiger auf die Schnittstelle für seinen Standort zu übergeben.
Syntax
HRESULT SetSite(
[in] IUnknown *pUnkSite
);
Parameter
[in] pUnkSite
Ein Zeiger auf den IUnknown-Schnittstellenzeiger der Website, die dieses Objekt verwaltet. Wenn NULL, sollte das Objekt Release für einen beliebigen vorhandenen Standort aufrufen, an dem das Objekt seinen Standort nicht mehr kennt.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück.
Hinweise
Das Objekt sollte diesen Zeiger halten und dabei IUnknown::AddRef aufrufen. Wenn das Objekt bereits über eine Website verfügt, sollte es IUnknown::Release dieser vorhandenen Website aufrufen, den neuen Websitezeiger speichern und IUnknown::AddRef der neuen Website aufrufen.
E_NOTIMPL ist nicht zulässig. Ohne Implementierung der SetSite-Methode ist die IObjectWithSite-Schnittstelle nicht erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |