ITTAPIEventNotification::Event method (tapi3if.h)

The Event method is called by TAPI to determine the response to an asynchronous event notification. The application implements a set of case statements that use TapiEvent to determine the type of event being signaled, then calls IUnknown::QueryInterface on pEvent to obtain the appropriate event interface pointer. Each event defined by TAPI 3 has an interface associated with it. The specific events handled depend on the needs of the application.

Syntax

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

Parameters

[in] TapiEvent

TAPI_EVENT indicator of the event.

[in] pEvent

Pointer to an IDispatch interface of the object associated with this event.

Return value

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
E_POINTER	The pEvent parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

You must call the ITTAPI::put_EventFilter method to set the event filter mask and enable reception of events. If you do not call ITTAPI::put_EventFilter, your application will not receive any events.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h
Library	Uuid.lib
DLL	Tapi3.dll

See also

Events overview

ITTAPIEventNotification

Register Events code snippet

TAPI_EVENT