ITTAPIEventNotification::Event-Methode (tapi3if.h)

Artikel
03/02/2024

Die Event-Methode wird von TAPI aufgerufen, um die Antwort auf eine asynchrone Ereignisbenachrichtigung zu bestimmen. Die Anwendung implementiert eine Reihe von Fallanweisungen, die TapiEvent verwenden, um den Typ des zu signalisierenden Ereignisses zu bestimmen, und ruft dann IUnknown::QueryInterface für pEvent auf, um den entsprechenden Ereignisschnittstellenzeiger abzurufen. Jedem durch TAPI 3 definierten Ereignis ist eine Schnittstelle zugeordnet. Welche spezifischen Ereignisse behandelt werden, hängt von den Anforderungen der Anwendung ab.

Syntax

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

Parameter

[in] TapiEvent

TAPI_EVENT Indikator des Ereignisses.

[in] pEvent

Zeiger auf eine IDispatch-Schnittstelle des Objekts, das diesem Ereignis zugeordnet ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Der pEvent-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

Sie müssen die ITTAPI::p ut_EventFilter-Methode aufrufen, um die Ereignisfiltermaske festzulegen und den Empfang von Ereignissen zu aktivieren. Wenn Sie ITTAPI::p ut_EventFilter nicht aufrufen, empfängt Ihre Anwendung keine Ereignisse.