IAxWinAmbientDispatchEx Interface

Essa interface implementa propriedades de ambiente suplementares para um controle hospedado.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch

Membros

Métodos

Nome	Descrição
SetAmbientDispatch	Esse método é chamado para complementar a interface de propriedade ambiente padrão com uma interface definida pelo usuário.

Comentários

Inclua essa interface em aplicativos ATL que estão vinculados estaticamente a ATL e hospedam controles ActiveX, especialmente controles ActiveX que possuem propriedades de ambiente. Não incluir essa interface gerará essa declaração: "Você esqueceu de passar o LIBID para CComModule::Init"

Essa interface é exposta pelos objetos de hospedagem de controle ActiveX da ATL. Derivado de IAxWinAmbientDispatch, IAxWinAmbientDispatchEx adiciona um método que permite complementar a interface de propriedade ambiente fornecida pela ATL com uma de sua preferência.

AxHost tentará carregar informações de tipo sobre IAxWinAmbientDispatch e IAxWinAmbientDispatchEx da biblioteca de tipos que contém o código.

Se você estiver vinculando a ATL90.dll, AXHost carregará as informações de tipo da biblioteca de tipos na DLL.

Consulte Hospedando controles ActiveX usando ATL AXHost para obter mais detalhes.

Requisitos

A definição dessa interface está disponível em vários formulários, conforme mostrado na tabela a seguir.

Tipo de definição	Arquivo
IDL	atliface.idl
Biblioteca de tipos	ATL.dll
C++	atliface.h (também incluído em ATLBase.h)

IAxWinAmbientDispatchEx::SetAmbientDispatch

Esse método é chamado para complementar a interface de propriedade ambiente padrão com uma interface definida pelo usuário.

virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;

Parâmetros

pDispatch
Ponteiro para a nova interface .

Valor de Devolução

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Comentários

Quando SetAmbientDispatch for chamado com um ponteiro para uma nova interface, essa nova interface será usada para invocar quaisquer propriedades ou métodos solicitados pelo controle hospedado, se essas propriedades ainda não tiverem sido fornecidas por IAxWinAmbientDispatch.

Confira também

Interface IAxWinAmbientDispatch