Metodo ITTAPIEventNotification::Event (tapi3if.h)

Articolo
03/13/2024

Il metodo Event viene chiamato da TAPI per determinare la risposta a una notifica degli eventi asincrona. L'applicazione implementa un set di istruzioni case che usano TapiEvent per determinare il tipo di evento segnalato, quindi chiama IUnknown::QueryInterface su pEvent per ottenere il puntatore all'interfaccia evento appropriato. A ogni evento definito da TAPI 3 è associata un'interfaccia. Gli eventi specifici gestiti dipendono dalle esigenze dell'applicazione.

Sintassi

HRESULT Event(
  [in] TAPI_EVENT TapiEvent,
  [in] IDispatch  *pEvent
);

Parametri

[in] TapiEvent

TAPI_EVENT indicatore dell'evento.

[in] pEvent

Puntatore a un'interfaccia IDispatch dell'oggetto associato a questo evento.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pEvent non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

È necessario chiamare il metodo ITTAPI::p ut_EventFilter per impostare la maschera di filtro eventi e abilitare la ricezione degli eventi. Se non si chiama ITTAPI::p ut_EventFilter, l'applicazione non riceverà alcun evento.