ITTAPI::Metode RegisterCallNotifications (tapi3if.h)

Artikel
08/26/2023

Metode RegisterCallNotifications menetapkan pemberitahuan panggilan baru mana yang akan diterima aplikasi. Aplikasi harus memanggil metode untuk setiap alamat, menunjukkan jenis atau jenis media yang dapat ditanganinya, dan menentukan hak istimewa yang dimintanya.

Aplikasi yang hanya akan melakukan panggilan keluar tidak perlu memanggil metode ini.

Antarmuka keluar ITTAPIEventNotification harus didaftarkan sebelum memanggil metode ini.

Jika hak istimewa pemilik dan pemantauan diperlukan untuk alamat, metode ini harus dipanggil hanya sekali, dengan fMonitor dan fOwner diatur ke TRUE.

Sintaks

HRESULT RegisterCallNotifications(
  [in]  ITAddress    *pAddress,
  [in]  VARIANT_BOOL fMonitor,
  [in]  VARIANT_BOOL fOwner,
  [in]  long         lMediaTypes,
  [in]  long         lCallbackInstance,
  [out] long         *plRegister
);

Parameter

[in] pAddress

Penunjuk ke antarmuka ITAddress .

[in] fMonitor

Nilai Boolean yang menunjukkan apakah aplikasi akan memantau panggilan. VARIANT_TRUE menunjukkan bahwa aplikasi akan memantau panggilan; VARIANT_FALSE bahwa itu tidak akan.

[in] fOwner

Nilai Boolean menunjukkan apakah aplikasi akan memiliki panggilan masuk. VARIANT_TRUE menunjukkan bahwa aplikasi akan memiliki panggilan masuk; VARIANT_FALSE menunjukkan bahwa itu tidak akan.

[in] lMediaTypes

Jenis media yang dapat ditangani oleh aplikasi.

[in] lCallbackInstance

Instans panggilan balik yang akan digunakan oleh DLL TAPI 3. Dapat berupa nilai gulAdvise yang dikembalikan oleh IConnectionPoint::Advise selama pendaftaran antarmuka keluar ITTAPIEventNotification .

[out] plRegister

Jika berhasil, nilai yang dikembalikan yang digunakan oleh ITTAPI::UnregisterNotifications.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter plRegister bukan penunjuk yang valid.
TAPI_E_NOT_INITIALIZED	Objek TAPI belum diinisialisasi.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.

Keterangan

Jika beberapa panggilan metode ini digunakan pada satu alamat, informasi tentang panggilan peserta dari hub panggilan mungkin membingungkan jika panggilan yang sudah dipantau oleh aplikasi diserahkan kepadanya.

Metode RegisterCallNotifications mendaftarkan aplikasi sebagai memiliki minat dalam memantau panggilan atau menerima kepemilikan panggilan yang merupakan jenis media yang ditentukan. Hak istimewa panggilan ini diatur dalam parameter fMonitor dan fOwner . Aplikasi dapat menentukan beberapa bendera untuk menangani beberapa jenis media. Konflik dapat muncul jika beberapa aplikasi mendaftar untuk alamat dan jenis media yang sama. Konflik ini diselesaikan dengan skema prioritas di mana pengguna menetapkan prioritas relatif untuk aplikasi. Pengguna dapat mengatur prioritas aplikasi dengan memanggil fungsi ITTAPI::SetApplicationPriority . Hanya aplikasi prioritas tertinggi untuk jenis media tertentu yang akan menerima kepemilikan (tidak diminta) dari panggilan jenis media tersebut. Kepemilikan dapat diterima ketika panggilan masuk pertama kali tiba atau ketika panggilan diserahkan. Fungsi ITBasicCallControl::HandoffDirect dan ITBasicCallControl::HandoffIndirect dipanggil untuk menyerahkan kepemilikan panggilan ke aplikasi lain. Jika pengguna tidak menetapkan prioritas ke aplikasi, dan beberapa aplikasi membuka perangkat baris yang sama, secara default, aplikasi yang disebut RegisterCallNotifications terlebih dahulu akan memiliki prioritas tertinggi.