IOleClientSite::GetContainer-Methode (oleidl.h)

  • Artikel

Ruft einen Zeiger auf den Container des Objekts ab.

Syntax

HRESULT GetContainer(
  [out] IOleContainer **ppContainer
);

Parameter

[out] ppContainer

Adresse der IOleContainer-Zeigervariable , die den Schnittstellenzeiger auf das Containerobjekt empfängt. Wenn ein Fehler auftritt, muss die Implementierung ppContainer auf NULL festlegen.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
OLE_E_NOT_SUPPORTED
 Der Clientstandort befindet sich in einem OLE 1-Container.
E_NOINTERFACE
 Der Container implementiert die IOleContainer-Schnittstelle nicht.

Hinweise

Wenn ein Container Links zu seinen eingebetteten Objekten unterstützt, können Linkclients durch die Implementierung von GetContainer die Objekte des Containers auflisten und eine Containmenthierarchie rekursiv durchlaufen. Diese Methode ist optional, wird jedoch für alle Container empfohlen, die Links zu ihren eingebetteten Objekten unterstützen.

Linkclients können eine Hierarchie zusammengesetzter Dokumentobjekte durchlaufen, indem sie GetContainer rekursiv aufrufen, um einen Zeiger auf den Container der Linkquelle abzurufen. gefolgt von QueryInterface , um einen Zeiger auf die IOleObject-Schnittstelle des Containers zu erhalten, und schließlich IOleObject::GetClientSite , um den Clientstandort des Containers in seinem Container abzurufen.

Einfache Container, die keine Links zu ihren eingebetteten Objekten unterstützen, müssen diese Methode wahrscheinlich nicht implementieren. Stattdessen können sie E_NOINTERFACE zurückgeben und ppContainer auf NULL festlegen.

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

IOleClientSite