Platform SDK: TAPI

ITTAPIEventNotification::Event

TAPI calls this method 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.0 has an interface associated with it. The specific events handled depend on the needs of the application.

HRESULT Event(
  TAPI_EVENT TapiEvent,
  IDispatch *pEvent
);

Parameters

TapiEvent: [in] TAPI_EVENT indicator of event.
pEvent: [in] Pointer to IDispatch interface of the object associated with this event.

Return Values

Value	Meaning
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

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

ITTAPIEventNotification::Event

Parameters

Return Values

Remarks

Requirements

See Also