Interfaccia IAxWinAmbientDispatchEx
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 a 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.dll |
| 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.