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

Artigo
03/13/2024

O método Event é chamado pelo TAPI para determinar a resposta a uma notificação de evento assíncrono. O aplicativo implementa um conjunto de instruções case que usam TapiEvent para determinar o tipo de evento que está sendo sinalizado e, em seguida, chama IUnknown::QueryInterface no pEvent para obter o ponteiro de interface de evento apropriado. Cada evento definido pelo TAPI 3 tem uma interface associada a ele. Os eventos específicos tratados dependem das necessidades do aplicativo.

Sintaxe

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

Parâmetros

[in] TapiEvent

TAPI_EVENT indicador do evento.

[in] pEvent

Ponteiro para uma interface IDispatch do objeto associado a esse evento.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pEvent não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.

Comentários

Você deve chamar o método ITTAPI::p ut_EventFilter para definir a máscara de filtro de evento e habilitar a recepção de eventos. Se você não chamar ITTAPI::p ut_EventFilter, seu aplicativo não receberá nenhum evento.