IOleClientSite::GetContainer
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Thismethod solicita um ponteiro para contêiner de um objeto.
Syntax
HRESEUT GetContainer(
LPOLECONTAINTER FAR* ppContainer
);
Parameters
ppContainer
[out] Endereço do IOleContainervariável * pointer que recebe o ponteiro interface para o objeto contêiner.Se ocorrer um erro, a implementação deve definir *ppContainer para NULL.
Return Value
Um dos valores na seguinte tabela é retornada.
| Valor | Descrição |
|---|---|
S_OK |
O ponteiro para do o contêiner IOleContainer interface foi retornado. |
OLE_E_NOT_SUPPORTED |
Site do cliente está no contêiner OLE 1. |
E_NOINTERFACE |
O contêiner não implementar o IOleContainer interface. |
Remarks
Se um contêiner oferecer suporte a links para seu incorporado objetos, implementação GetContainer Permite que os clientes link enumerar objetos e recursivamente do o contêiner atravessar uma hierarquia de retenção.
Este método é opcional mas recomendado para todos os recipientes que pretende suporte links para seus incorporado objetos.
Vínculo que os clientes podem atravessar uma hierarquia de compostos-objetos documento por chamado recursivamente GetContainer Para get um ponteiro para contêiner a origem link; seguido por IOleContainer::QueryInterface Para um ponteiro para do o contêiner get IOleObject interface e, finalmente, IOleObject::GetClientSite Para get site cliente do contêiner no seu contêiner.
Simples recipientes que não suporte links para seus incorporado objetos provavelmente não é necessário para implementar este método. Em vez disso, eles podem retornar E_NOINTERFACE e definir ppContainer para NULL.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requirements
| Header | Oleidl.h, oleidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IOleClientSite
IOleObject
IOleObject::GetClientSite