COM_INTERFACE_ENTRY_FUNC ( iid, dw, func )
Parametri
iid
[in] Il GUID dell'interfaccia esposta.
dw
[in] Un parametro passato alla func.
func
[in] Il puntatore a funzione restituirā iid.
Osservazioni
Un meccanismo generale per aggancio nella logica QueryInterface di ATL. Se iid corrisponde l' IID dell'interfaccia di query per, quindi viene chiamata la funzione specificata da func . La dichiarazione della funzione dovrebbe essere:
HRESULT WINAPI func (void * pv, REFIID riid, LPVOID * ppv, DWORD dw)
Quando la funzione viene chiamata, pv punti all'oggetto classe. Il parametro riid si riferisce all'interfaccia sottoposta a query per, ppv č il puntatore alla posizione dove la funzione deve archiviare il puntatore all'interfaccia e dw č il parametro specificato nella voce. La funzione deve essere impostato *ppv a NULL e ritorno E_NOINTERFACE o S_FALSE se sceglie di non restituire un'interfaccia. Con E_NOINTERFACE, termina l'elaborazione mappa COM. Con S_FALSE, COM mappa l'elaborazione continua, anche se č stato restituito alcun puntatore a interfaccia. Se la funzione restituisce un puntatore a interfaccia, deve essere restituito S_OK.
Per osservazioni su voci mappa COM, vedere Le macro COM_INTERFACE_ENTRY.