Dial

Operasi putar nomor memungkinkan aplikasi mengirim digit tambahan pada sesi yang dibuat sebelumnya. Contoh penggunaan putar nomor parsial adalah dengan memutar nomor ekstensi. Panggilan parsial kadang-kadang disebut sebagai putar nomor inkremental atau panggilan tertunda.

Ketika alamat yang diberikan tidak lengkap, memutar beberapa digit mungkin tertunda dengan menempatkan titik koma (;) di akhir angka. Operasi putar nomor kemudian digunakan untuk mengirim data alamat tambahan pada sesi yang ada, seperti memanggil alamat pihak tempat panggilan akan ditransfer.

Setiap penyedia layanan harus menolak string putar nomor yang berisi karakter ? dan membiarkan aplikasi menanganinya sebagaimana mestinya. Misalnya, aplikasi dapat menggunakan panggilan parsial untuk memutar nomor string, hingga, tetapi tidak menyertakan karakter ? , lalu menampilkan dialog untuk membiarkan sinyal pengguna ketika string putar nomor lainnya harus dihubungi.

Alasan tambahan bagi aplikasi untuk menggunakan panggilan parsial adalah jika penyedia layanan tidak mendukung satu atau beberapa karakter kontrol deteksi kemajuan panggilan. Karakter ini, yang dapat terjadi dalam alamat dapat dialable, adalah W (tunggu nada panggil); @ (tunggu jawaban tenang); dan $ (tunggu nada permintaan kartu panggilan). Ini dan semua karakter lain yang digunakan dalam string alamat dibahas secara lebih rinci dalam Dialable Addresses.

Penyedia menunjukkan pengubah string putar nomor "tunggu" mana yang didukungnya. Aplikasi TAPI 2 menemukan data ini di anggota dwDevCapFlags dari struktur LINEDEVCAPS yang dikembalikan oleh lineGetDevCaps. Aplikasi TAPI 3 memanggil ITAddressCapabilities::get_AddressCapability dengan AddressCap diatur ke anggota ADDRESS_CAPABILITY AC_DEVCAPFLAGS.

Aplikasi dapat memilih untuk memprakarsai string yang dapat dialihkan untuk karakter yang tidak didukung atau dapat meneruskan string "mentah" sebagai bagian dari memulai sesi. Jika string berisi pengubah yang tidak didukung atau "?", penyedia akan mengembalikan kesalahan yang menunjukkan pengubah yang melanggar mana yang terjadi terlebih dahulu dalam string:

  • LINEERR_DIALBILLING
  • LINEERR_DIALQUIET
  • LINEERR_DIALDIALTONE
  • LINEERR_DIALPROMPT

Aplikasi kemudian dapat menemukan pengubah yang menyinggung dalam string, mengambil digit di sebelah kiri pengubah, menambahkan titik koma, dan memulai sesi menggunakan alamat parsial. Sisa string dapat dikirim menggunakan operasi putar nomor.

Tidak semua penyedia layanan mendukung penggunaan operasi ini.

TAPI 2.x: Lihat lineDial.

TAPI 3.x: Lihat ITBasicCallControl::D ial.