IOleClientSite::GetContainer-Methode (oleidl.h)
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 |
|---|---|
|
Der Clientstandort befindet sich in einem OLE 1-Container. |
|
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 |