fungsi lineDial (tapi.h)

Artikel
08/26/2023

Fungsi lineDial memanggil nomor putar yang ditentukan pada panggilan yang ditentukan.

Sintaks

LONG lineDial(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parameter

hCall

Tangani ke panggilan di mana nomor akan dihubungi. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall dapat menjadi status apa pun kecuali diam dan terputus.

lpszDestAddress

Tujuan yang akan dipanggetkan menggunakan format nomor bisa-putar standar.

dwCountryCode

Kode negara atau wilayah tujuan. Ini digunakan oleh implementasi untuk memilih protokol kemajuan panggilan untuk alamat tujuan. Jika nilai 0 ditentukan, protokol kemajuan panggilan default yang ditentukan penyedia layanan akan digunakan.

Menampilkan nilai

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron, atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_ADDRESSBLOCKED, LINEERR_INVALPOINTER, LINEERR_DIALBILLING, LINEERR_NOMEM, LINEERR_DIALDIALTONE, LINEERR_NOTOWNER, LINEERR_DIALPROMPT, LINEERR_OPERATIONFAILED, LINEERR_DIALQUIET, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE.

Keterangan

Jika LINEERR_INVALADDRESS dikembalikan, tidak ada panggilan yang dilakukan. Jika LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE, atau LINEERR_DIALPROMPT dikembalikan, tidak ada tindakan yang dilakukan oleh lineDial yang terjadi. Misalnya, tidak ada alamat yang dapat dialihkan sebelum karakter yang menyinggung telah dipanggang, tidak ada status hookswitch yang berubah, dan sebagainya.

Fungsi lineDial digunakan untuk memutar nomor pada tampilan panggilan yang ada. Misalnya, setelah panggilan disiapkan untuk transfer atau konferensi, panggilan konsultasi dialokasikan secara otomatis, dan fungsi lineDial akan digunakan untuk melakukan panggilan konsultasi ini. Fungsi lineDial dapat dipanggil beberapa kali dalam proses panggilan multistage, jika kemampuan perangkat garis memungkinkannya. Selain itu, beberapa alamat dapat disediakan dalam satu string dial yang dipisahkan oleh CRLF. Penyedia layanan yang menyediakan multipleks terbalik dapat membuat panggilan fisik individual dengan setiap alamat dan dapat mengembalikan satu handel panggilan ke agregat semua panggilan ke aplikasi. Semua alamat akan menggunakan kode negara atau wilayah yang sama.

Panggilan dianggap selesai setelah alamat diteruskan ke penyedia layanan; tidak setelah panggilan akhirnya terhubung. Penyedia layanan yang menyediakan multipleks terbalik dapat memungkinkan beberapa alamat disediakan sekaligus. Penyedia layanan mengirim pesan LINE_CALLSTATE ke aplikasi untuk menginformasikannya tentang kemajuan panggilan. Untuk membatalkan upaya panggilan saat panggilan sedang dibuat, aplikasi pemanggilan harus menggunakan lineDrop.

Aplikasi dapat mengatur parameter lpszDestAddress dari fungsi lineDial ke alamat string kosong untuk menunjukkan bahwa panggilan selesai, tetapi hanya jika panggilan sebelumnya ke fungsi lineMakeCall dan lineDial telah memiliki string yang ditentukan oleh lpszDestAddress yang diakhiri dengan titik koma.

Fungsi lineDial juga dapat digunakan dalam putar nomor parsial. Untuk memulai panggilan menggunakan panggilan parsial, aplikasi memanggil lineMakeCall dan menentukan string panggilan parsial. String putar nomor parsial adalah string putar nomor apa pun yang dihentikan oleh titik koma. Panggilan biasanya akan beralih ke LINECALLSTATE_DIALING setelah lineDial dapat dipanggil untuk menentukan lebih banyak string panggilan, masing-masing dihentikan oleh titik koma. Panggilan selesai dengan memanggil lineDial dengan string putar nomor yang tidak dihentikan dengan titik koma (seperti string kosong). Teknik ini memungkinkan aplikasi untuk melakukan panggilan parsial interaktif dengan pengguna atau mengaktifkan panggilan yang lebih canggih daripada yang mampu dilakukan TSP.

Jika string tujuan null, atau string kosong dihentikan dengan titik koma (";") dimasukkan di lineMakeCall , aplikasi beralih ke LINE_CALLSTATE_DIALTONE. Fungsi lineDial dapat dipanggil dalam status ini untuk memasukkan string putar nomor tunggal atau beberapa string putar nomor parsial, masing-masing dipisahkan oleh titik koma. Aplikasi beralih ke status LINECALLSTATE_DIALING setelah digit pertama dimasukkan.

Catatan Fungsi lineDial hanya tersedia saat panggilan berada di LINECALLSTATE_DIALING atau LINE_CALLSTATE_DIALTONE. Jika DTMF diperlukan saat panggilan tersambung (LINECALLSTATE_CONNECTED), gunakan lineGenerateDigits.