Método IOleClientSite::GetContainer (oleidl.h)

Recupera un puntero al contenedor del objeto.

Sintaxis

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

Parámetros

[out] ppContainer

Dirección de la variable de puntero IOleContainer que recibe el puntero de interfaz al objeto contenedor. Si se produce un error, la implementación debe establecer ppContainer en NULL.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
OLE_E_NOT_SUPPORTED	El sitio cliente está en un contenedor OLE 1.
E_NOINTERFACE	El contenedor no implementa la interfaz IOleContainer .

Comentarios

Si un contenedor admite vínculos a sus objetos incrustados, la implementación de GetContainer permite a los clientes de vínculo enumerar los objetos del contenedor y recorrer de forma recursiva una jerarquía de contención. Este método es opcional, pero se recomienda para todos los contenedores que esperan admitir vínculos a sus objetos incrustados.

Los clientes de vínculo pueden atravesar una jerarquía de objetos de documento compuesto llamando recursivamente a GetContainer para obtener un puntero al contenedor del origen del vínculo; seguido de QueryInterface para obtener un puntero a la interfaz IOleObject del contenedor y, por último, IOleObject::GetClientSite para obtener el sitio cliente del contenedor en su contenedor.

Los contenedores simples que no admiten vínculos a sus objetos incrustados probablemente no necesiten implementar este método. En su lugar, pueden devolver E_NOINTERFACE y establecer ppContainer en NULL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleidl.h

Consulte también

IOleClientSite