Метод ITTAPIEventNotification::Event (tapi3if.h)

Статья
08/26/2023

Метод Event вызывается TAPI для определения ответа на асинхронное уведомление о событии. Приложение реализует набор операторов case, которые используют TapiEvent для определения типа сигнального события, а затем вызывает IUnknown::QueryInterface в pEvent , чтобы получить соответствующий указатель интерфейса события. Каждое событие, определенное TAPI 3, имеет связанный с ним интерфейс. Конкретные обработанные события зависят от потребностей приложения.

Синтаксис

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

Параметры

[in] TapiEvent

TAPI_EVENT индикатор события.

[in] pEvent

Указатель на интерфейс IDispatch объекта, связанного с этим событием.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Метод успешно выполнен.
E_POINTER	Параметр pEvent не является допустимым указателем.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.

Чтобы задать маску фильтра событий и включить прием событий, необходимо вызвать метод ITTAPI::p ut_EventFilter . Если вы не вызываете ITTAPI::p ut_EventFilter, приложение не будет получать никаких событий.