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
OLE_E_NOT_SUPPORTED	Il sito client si trova in un contenitore OLE 1.
E_NOINTERFACE	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

Vedi anche

Ioleclientsite