IObjectWithSite-Schnittstelle (ocidl.h)

  • Artikel

Bietet eine einfache Möglichkeit, die Kommunikation zwischen einem Objekt und seinem Standort im Container zu unterstützen.

Häufig muss ein Objekt direkt mit einem Containerwebsiteobjekt kommunizieren und das Standortobjekt selbst verwalten. Außerhalb von IOleObject::SetClientSite gibt es keine generischen Mittel, über die ein Objekt seine Website erkennt. IObjectWithSite bietet einfache Objekte mit einem einfachen Sitzmechanismus (leichter als IOleObject). Diese Schnittstelle sollte nur verwendet werden, wenn IOleObject noch nicht verwendet wird.

Über IObjectWithSite kann ein Container den IUnknown-Zeiger seiner Website über IObjectWithSite::SetSite an das Objekt übergeben. Aufrufer können auch die neueste Website abrufen, die über IObjectWithSite::GetSite an SetSite übergeben wurde. Diese letztere Methode ist als Hookingmechanismus enthalten, der es einem Drittanbieter ermöglicht, Aufrufe vom Objekt an die Website abzufangen.

Vererbung

Die IObjectWithSite-Schnittstelle erbt von der IUnknown-Schnittstelle . IObjectWithSite verfügt auch über die folgenden Membertypen:

Methoden

Die IObjectWithSite-Schnittstelle verfügt über diese Methoden.

 
IObjectWithSite::GetSite

Ruft die neueste Website ab, die mit SetSite übergeben wurde.
IObjectWithSite::SetSite

Ermöglicht es einem Container, einem Objekt einen Zeiger auf die Schnittstelle für seinen Standort zu übergeben.

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