Compartilhar via

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

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Visão geral de eventos

ITTAPIEventNotification

Registrar snippet de código de eventos

TAPI_EVENT

  • Last updated on