Compartir a través de

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

  • Artículo

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