ITTAPIEventNotification::Metode peristiwa (tapi3if.h)

Artikel
03/04/2024

Metode Peristiwa dipanggil oleh TAPI untuk menentukan respons terhadap pemberitahuan peristiwa asinkron. Aplikasi ini menerapkan serangkaian pernyataan kasus yang menggunakan TapiEvent untuk menentukan jenis peristiwa yang disinyalkan, lalu memanggil IUnknown::QueryInterface di pEvent untuk mendapatkan penunjuk antarmuka peristiwa yang sesuai. Setiap peristiwa yang ditentukan oleh TAPI 3 memiliki antarmuka yang terkait dengannya. Peristiwa spesifik yang ditangani tergantung pada kebutuhan aplikasi.

Sintaks

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

Parameter

[in] TapiEvent

TAPI_EVENT indikator peristiwa.

[in] pEvent

Penunjuk ke antarmuka IDispatch objek yang terkait dengan peristiwa ini.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter pEvent bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.

Keterangan

Anda harus memanggil metode ITTAPI::p ut_EventFilter untuk mengatur masker filter peristiwa dan mengaktifkan penerimaan peristiwa. Jika Anda tidak memanggil ITTAPI::p ut_EventFilter, aplikasi Anda tidak akan menerima peristiwa apa pun.