Freigeben über


ITTAPIEventNotification::Event-Methode (tapi3if.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

Übersicht über Ereignisse

ITTAPIEventNotification

Codeausschnitt "Ereignisse registrieren"

TAPI_EVENT