Método ITTAPIEventNotification::Event (tapi3if.h)

Artículo
03/02/2024

TAPI llama al método Event para determinar la respuesta a una notificación de eventos asincrónica. La aplicación implementa un conjunto de instrucciones case que usan TapiEvent para determinar el tipo de evento que se señala y, a continuación, llama a IUnknown::QueryInterface en pEvent para obtener el puntero de interfaz de evento adecuado. Cada evento definido por TAPI 3 tiene una interfaz asociada a él. Los eventos específicos controlados dependen de las necesidades de la aplicación.

Sintaxis

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

Parámetros

[in] TapiEvent

TAPI_EVENT indicador del evento.

[in] pEvent

Puntero a una interfaz IDispatch del objeto asociado a este evento.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pEvent no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

Debe llamar al método ITTAPI::p ut_EventFilter para establecer la máscara de filtro de eventos y habilitar la recepción de eventos. Si no llama a ITTAPI::p ut_EventFilter, la aplicación no recibirá ningún evento.