IObjectWithSite::SetSite-Methode (ocidl.h)

  • Artikel

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

Weitere Informationen

Iobjectwithsite