ITPhoneEvent-Schnittstelle (tapi3if.h)

Die ITPhoneEvent-Schnittstelle enthält Methoden, die die Beschreibung der aufgetretenen Telefonereignisse abrufen. Wenn die Implementierung der ITTAPIEventNotification::Event-Methode der Anwendung einen TAPI_EVENT angibt, der TE_PHONEEVENT entspricht, ist der pEvent-Parameter der Methode ein IDispatch-Zeiger für die ITPhoneEvent-Schnittstelle .

Hinweis Sie müssen die ITTAPI::p ut_EventFilter-Methode aufrufen und eine Ereignisfiltermaske festlegen, die TE_PHONEEVENT enthält, um den Empfang von Telefonereignissen zu aktivieren. Wenn Sie ITTAPI::p ut_EventFilter nicht aufrufen, empfängt Ihre Anwendung keine Ereignisse. Weitere Informationen finden Sie in der Übersicht über Ereignisse .

 

Vererbung

Die ITPhoneEvent-Schnittstelle erbt von der IDispatch-Schnittstelle . ITPhoneEvent verfügt auch über folgende Arten von Membern:

Methoden

Die ITPhoneEvent-Schnittstelle verfügt über diese Methoden.

ITPhoneEvent::get_ButtonLampId Die get_ButtonLampId-Methode gibt einen langen Wert zurück, der angibt, welche Schaltfläche oder Lampe das Ereignis ausgelöst hat. Diese Informationen sind nur verfügbar, wenn ITPhoneEvent::get_Event PE_LAMPMODE oder PE_BUTTON zurückgibt.
ITPhoneEvent::get_ButtonState Die get_ButtonState-Methode gibt einen PHONE_BUTTON_STATE Wert zurück, der den Zustand angibt, in den die Schaltfläche übergetreten ist. Diese Informationen sind nur verfügbar, wenn die ITPhoneEvent::get_Event-Methode PE_BUTTON zurückgibt.
ITPhoneEvent::get_Call Die get_Call-Methode gibt einen Zeiger auf die ITCallInfo-Schnittstelle für das am Ereignis beteiligte Aufrufobjekt zurück.
ITPhoneEvent::get_Event Die get_Event-Methode gibt einen PHONE_EVENT Wert zurück, der den Typ des aufgetretenen Telefonereignisses angibt.
ITPhoneEvent::get_HookSwitchDevice Die get_HookSwitchDevice-Methode gibt einen PHONE_HOOK_SWITCH_DEVICE Wert zurück, der das Hookswitch-Gerät angibt, das den Zustand geändert hat. Diese Informationen sind nur verfügbar, wenn die ITPhoneEvent::get_Event-Methode PE_HOOKSWITCH zurückgibt.
ITPhoneEvent::get_HookSwitchState Die get_HookSwitchState-Methode gibt einen PHONE_HOOK_SWITCH_STATE Wert zurück, der den Zustand angibt, in den der Hookswitch übergetreten ist. Diese Informationen sind nur verfügbar, wenn die ITPhoneEvent::get_Event-Methode PE_HOOKSWITCH zurückgibt.
ITPhoneEvent::get_NumberGathered Die get_NumberGathered-Methode gibt einen BSTR-Wert zurück, der die erfasste Telefonnummer angibt. Diese Informationen sind nur verfügbar, wenn die ITPhoneEvent::get_Event-Methode PE_NUMBERGATHERED zurückgibt.
ITPhoneEvent::get_Phone Die get_Phone-Methode gibt einen Zeiger auf die ITPhone-Schnittstelle des Telefonobjekts zurück, das dieses Ereignis ausgelöst hat.
ITPhoneEvent::get_RingMode Die get_RingMode-Methode gibt einen langen Wert zurück, der den Ringmodus angibt, in den das Telefon gewechselt ist. Diese Informationen sind nur verfügbar, wenn die ITPhoneEvent::get_Event-Methode PE_RINGMODE zurückgibt.

Anforderungen

Zielplattform	Windows
Kopfzeile	tapi3if.h (einschließlich Tapi3.h)