Condividi tramite

Interfaccia IAxWinAmbientDispatchEx

  • Articolo

Questa interfaccia implementa proprietà di ambiente supplementari per un controllo ospitato.

Importante

Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.

Sintassi

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

Membri

Metodi

Nome Descrizione
SetAmbientDispatch Questo metodo viene chiamato per integrare l'interfaccia predefinita della proprietà di ambiente con un'interfaccia definita dall'utente.

Osservazioni:

Includere questa interfaccia nelle applicazioni ATL collegate staticamente ad ATL e ospitare controlli ActiveX, in particolare controlli ActiveX con proprietà di ambiente. Non inclusa questa interfaccia genererà questa asserzione: "Did you forget to pass the LIBID to CComModule::Init"

Questa interfaccia viene esposta dagli oggetti host del controllo ActiveX di ATL. Derivato da IAxWinAmbientDispatch, IAxWinAmbientDispatchEx aggiunge un metodo che consente di integrare l'interfaccia della proprietà di ambiente fornita da ATL con una delle proprie.

AxHost tenterà di caricare informazioni sul tipo su IAxWinAmbientDispatch e IAxWinAmbientDispatchEx dalla libreria dei tipi che contiene il codice.

Se si esegue il collegamento ad ATL90.dll, AXHost caricherà le informazioni sul tipo dalla libreria dei tipi nella DLL.

Per altri dettagli, vedere Hosting di controlli ActiveX tramite ATL AXHost .

Requisiti

La definizione di questa interfaccia è disponibile in diversi formati, come illustrato nella tabella seguente.

Tipo definizione file
IDL atliface.idl
Libreria dei tipi Atl
C++ atliface.h (incluso anche in ATLBase.h)

IAxWinAmbientDispatchEx::SetAmbientDispatch

Questo metodo viene chiamato per integrare l'interfaccia predefinita della proprietà di ambiente con un'interfaccia definita dall'utente.

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

Parametri

pDispatch
Puntatore alla nuova interfaccia.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Quando SetAmbientDispatch viene chiamato con un puntatore a una nuova interfaccia, questa nuova interfaccia verrà usata per richiamare eventuali proprietà o metodi richiesti dal controllo ospitato, se tali proprietà non sono già fornite da IAxWinAmbientDispatch.

Vedi anche

Interfaccia IAxWinAmbientDispatch