Metodo IOleClientSite::GetContainer (oleidl.h)
Recupera un puntatore al contenitore dell'oggetto.
Sintassi
HRESULT GetContainer(
[out] IOleContainer **ppContainer
);
Parametri
[out] ppContainer
Indirizzo della variabile del puntatore IOleContainer che riceve il puntatore dell'interfaccia all'oggetto contenitore. Se si verifica un errore, l'implementazione deve impostare ppContainer su NULL.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il sito client si trova in un contenitore OLE 1. |
|
Il contenitore non implementa l'interfaccia IOleContainer . |
Commenti
Se un contenitore supporta collegamenti agli oggetti incorporati, l'implementazione di GetContainer consente ai client di collegamento di enumerare gli oggetti del contenitore e attraversare in modo ricorsivo una gerarchia di contenimento. Questo metodo è facoltativo, ma consigliato per tutti i contenitori che prevedono di supportare i collegamenti agli oggetti incorporati.
I client di collegamento possono attraversare una gerarchia di oggetti documento composto chiamando in modo ricorsivo GetContainer per ottenere un puntatore al contenitore dell'origine del collegamento; seguito da QueryInterface per ottenere un puntatore all'interfaccia IOleObject del contenitore e, infine, IOleObject::GetClientSite per ottenere il sito client del contenitore nel contenitore.
I contenitori semplici che non supportano i collegamenti ai relativi oggetti incorporati probabilmente non devono implementare questo metodo. Possono invece restituire E_NOINTERFACE e impostare ppContainer su NULL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | oleidl.h |