phoneBuka fungsi (tapi.h)

Artikel
03/08/2023

Fungsi phoneBuka membuka perangkat telepon yang ditentukan. Perangkat telepon dapat dibuka menggunakan hak istimewa pemilik atau memantau hak istimewa. Aplikasi yang membuka ponsel dengan hak istimewa pemilik dapat mengontrol lampu, layar, dering, dan hookswitch atau hookswitch ponsel. Aplikasi yang membuka perangkat telepon dengan hak istimewa monitor hanya diberi tahu tentang peristiwa yang terjadi di ponsel, seperti perubahan hookswitch atau penekanan tombol.

Kepemilikan perangkat telepon bersifat eksklusif. Dengan kata lain, hanya satu aplikasi yang dapat membuka perangkat telepon dengan hak istimewa pemilik pada satu waktu. Namun, perangkat telepon dapat dibuka beberapa kali dengan hak istimewa monitor.

Sintaks

LONG phoneOpen(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  LPHPHONE  lphPhone,
  DWORD     dwAPIVersion,
  DWORD     dwExtVersion,
  DWORD_PTR dwCallbackInstance,
  DWORD     dwPrivilege
);

Parameter

hPhoneApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Pengidentifikasi perangkat telepon yang akan dibuka.

lphPhone

Penunjuk ke handel HPHONE yang mengidentifikasi perangkat telepon terbuka. Gunakan handel ini untuk mengidentifikasi perangkat saat memanggil fungsi kontrol telepon lainnya.

dwAPIVersion

Nomor versi API di mana aplikasi dan TELEPHONY API telah setuju untuk beroperasi. Nomor ini diperoleh dari phoneNegotiateAPIVersion.

dwExtVersion

Nomor versi ekstensi tempat aplikasi dan penyedia layanan setuju untuk beroperasi. Angka ini nol jika aplikasi tidak menggunakan ekstensi apa pun. Nomor ini diperoleh dari phoneNegotiateExtVersion.

dwCallbackInstance

Data instans pengguna diteruskan kembali ke aplikasi dengan setiap pesan. Parameter ini tidak ditafsirkan oleh TELEPHONY API.

dwPrivilege

Hak istimewa diminta. Parameter ini menggunakan satu dan hanya satu dari konstanta PHONEPRIVILEGE_.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_ALLOCATED, PHONEERR_NODRIVER, PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALAPPHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_INVALPRIVILEGE, PHONEERR_REINIT, PHONEERR_INUSE, PHONEERR_NODEVICE, PHONEERR_INIFILECORRUPT.

Keterangan

Saat membuka perangkat telepon dengan hak istimewa monitor, aplikasi dikirimi pesan ketika peristiwa terjadi yang mengubah status telepon. Pesan yang dikirim ke aplikasi mencakup PHONE_BUTTON dan PHONE_STATE. Yang terakhir memberikan indikasi item status telepon yang telah berubah.

Saat membuka ponsel dengan hak istimewa pemilik, perangkat telepon dapat dimanipulasi dengan cara yang memengaruhi status perangkat telepon. Aplikasi hanya boleh membuka ponsel menggunakan hak istimewa pemilik jika secara aktif ingin memanipulasi perangkat telepon, dan itu harus menutup perangkat telepon ketika selesai untuk memungkinkan aplikasi lain mengontrol telepon.

Ketika aplikasi membuka perangkat telepon, aplikasi harus menentukan versi API yang dinegosiasikan dan, jika ingin menggunakan ekstensi ponsel, versi ekstensi khusus perangkat ponsel. Nomor versi ini seharusnya diperoleh dengan fungsi phoneNegotiateAPIVersion dan phoneNegotiateExtVersion . Penomoran versi memungkinkan campuran dan kecocokan versi aplikasi yang berbeda dengan versi API dan versi penyedia layanan yang berbeda.