fungsi lineTranslateDialog (tapi.h)

Artikel
03/08/2023

Fungsi lineTranslateDialog menampilkan kotak dialog modal aplikasi yang memungkinkan pengguna mengubah lokasi nomor telepon saat ini yang akan dihubungi, menyesuaikan parameter lokasi dan kartu panggilan, dan melihat efeknya.

Sintaks

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

Parameter

hLineApp

Handel aplikasi yang dikembalikan oleh lineInitializeEx. Jika aplikasi belum memanggil fungsi lineInitializeEx , aplikasi dapat mengatur parameter hLineApp ke nol.

dwDeviceID

Pengidentifikasi perangkat untuk perangkat baris tempat panggilan dimaksudkan untuk dihubungi, sehingga variasi dalam prosedur panggilan pada baris yang berbeda dapat diterapkan ke proses terjemahan.

dwAPIVersion

Versi TERTINGGI TAPI yang didukung oleh aplikasi (belum tentu nilai yang dinegosiasikan oleh lineNegotiateAPIVersion pada perangkat baris yang ditunjukkan oleh dwDeviceID).

hwndOwner

Tangani ke jendela tempat kotak dialog akan dilampirkan. Dapat berupa nilai NULL untuk menunjukkan bahwa setiap jendela yang dibuat selama fungsi seharusnya tidak memiliki jendela pemilik.

lpszAddressIn

Penunjuk ke string yang dihentikan null yang berisi nomor telepon yang digunakan, di bagian bawah kotak dialog, untuk memperlihatkan efek perubahan pengguna pada parameter lokasi. Angka harus dalam format kanonis; jika noncanonical, bagian nomor telepon dari kotak dialog tidak ditampilkan. Penunjuk ini dapat dibiarkan NULL, dalam hal ini bagian nomor telepon dari kotak dialog tidak ditampilkan. Jika parameter lpszAddressIn berisi bidang subaddress atau nama, atau alamat tambahan yang dipisahkan dari alamat pertama menurut karakter CR dan LF, hanya alamat pertama yang digunakan dalam kotak dialog.

Nilai kembali

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

LINEERR_BADDEVICEID, LINEERR_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED.

Keterangan

Di TAPI versi 2.0 atau yang lebih baru, dimungkinkan bagi beberapa instans kotak dialog ini untuk dibuka. Dalam versi TAPI yang lebih lama dari 2.0, LINEERR_INUSE dikembalikan jika kotak dialog sudah ditampilkan oleh aplikasi lain (tidak dapat dibuka lebih dari sekali). Dalam versi ini, TAPI membawa kotak dialog yang ada ke depan, dan kesalahan menunjukkan bahwa setiap hal yang terkait dengan alamat yang diteruskan oleh aplikasi saat ini belum ditangani, karena alamat tersebut tidak diproses oleh fungsi.

Aplikasi harus memanggil lineGetTranslateCaps setelah fungsi ini untuk mendapatkan perubahan apa pun yang dilakukan pengguna pada parameter terjemahan alamat telepon, dan memanggil lineTranslateAddress untuk mendapatkan string yang dapat dialable berdasarkan pilihan baru pengguna.

Jika ada fungsi yang terkait dengan terjemahan alamat (misalnya, lineGetTranslateCaps atau lineTranslateAddress) mengembalikan LINEERR_INIFILECORRUPT, aplikasi harus memanggil lineTranslateDialog. Fungsi lineTranslateDialog mendeteksi kesalahan dan memperbaikinya, dan melaporkan tindakan yang diambil kepada pengguna.