IOleObject::GetClientSite-Methode (oleidl.h)

  • Artikel

Ruft einen Zeiger auf den Clientstandort eines eingebetteten Objekts ab.

Syntax

HRESULT GetClientSite(
  [out] IOleClientSite **ppClientSite
);

Parameter

[out] ppClientSite

Adresse der IOleClientSite-Zeigervariable , die den Schnittstellenzeiger auf den Clientstandort des Objekts empfängt. Wenn ein Objekt seinen Clientstandort noch nicht kennt oder ein Fehler aufgetreten ist, muss ppClientSite auf NULL festgelegt werden. Jedes Mal, wenn ein Objekt einen Aufruf von IOleObject::GetClientSite empfängt, muss die Verweisanzahl auf ppClientSite erhöht werden. Es liegt in der Verantwortung des Aufrufers , Release aufzurufen, wenn dies mit ppClientSite erfolgt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Linkclients rufen am häufigsten die IOleObject::GetClientSite-Methode zusammen mit der IOleClientSite::GetContainer-Methode auf, um eine Hierarchie geschachtelter Objekte zu durchlaufen. Ein Linkclient ruft IOleObject::GetClientSite auf, um einen Zeiger auf den Clientstandort der Linkquelle abzurufen. Der Client ruft dann IOleClientSite::GetContainer auf, um einen Zeiger auf den Container der Linkquelle abzurufen. Schließlich ruft der Client QueryInterface auf, um IOleObject und IOleObject::GetClientSite abzurufen, um die Clientwebsite des Containers innerhalb des Containers abzurufen. Durch Wiederholen dieser Aufrufsequenz kann der Aufrufer schließlich einen Zeiger auf den master Container abrufen, in dem alle anderen Objekte geschachtelt sind.

Hinweise für Anrufer

Der zurückgegebene Clientstandortzeiger ist NULL , wenn ein eingebettetes Objekt noch nicht über seinen Clientstandort informiert wurde. Dies ist bei einem neu geladenen oder erstellten Objekt der Fall, wenn ein Container einen NULL-Client-Site-Zeiger an eine der Hilfsfunktionen für die Objekterstellung übergeben hat, aber noch nicht IOleObject::SetClientSite als Teil der Initialisierung des Objekts aufgerufen hat.

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 oleidl.h

Weitere Informationen

IOleObject

IOleObject::SetClientSite