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 |
|---|---|
|
Method succeeded. |
|
The pEvent parameter is not a valid pointer. |
|
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 |