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 retorno
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.