fungsi TSPI_lineDial (tspi.h)

Fungsi TSPI_lineDial memanggil nomor dialable yang ditentukan pada panggilan yang ditentukan.

Sintaks

LONG TSPIAPI TSPI_lineDial(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Handel penyedia layanan ke panggilan untuk dihubungi. Status panggilan hdCall dapat menjadi status apa pun kecuali diam dan terputus.

lpszDestAddress

Penunjuk ke string Unicode yang dihentikan null yang menentukan tujuan yang akan diputar menggunakan format angka yang dapat dialihkan standar.

dwCountryCode

Kode negara atau wilayah tujuan. Implementasi menggunakan ini untuk memilih protokol kemajuan panggilan untuk alamat tujuan. Jika nilai 0 ditentukan, protokol kemajuan panggilan default yang ditentukan oleh penyedia layanan akan digunakan. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

Nilai kembali

Mengembalikan dwRequestID atau nomor kesalahan jika terjadi kesalahan. Parameter aktual lResult dari ASYNC_COMPLETION yang sesuai adalah nol jika fungsi berhasil atau nomor kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_DIALBILLING, LINEERR_INVALCALLSTATE, LINEERR_DIALQUIET, LINEERR_ADDRESSBLOCKED, LINEERR_DIALDIALTONE, LINEERR_NOMEM, LINEERR_DIALPROMPT, LINEERR_OPERATIONUNAVAIL.

Keterangan

Penyedia layanan mengembalikan LINEERR_INVALCALLSTATE jika status panggilan saat ini tidak mengizinkan panggilan.

Penyedia layanan tidak melakukan panggilan jika kembali LINEERR_INVALADDRESS.

Jika penyedia layanan mengembalikan LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE, atau LINEERR_DIALPROMPT, penyedia layanan tidak boleh melakukan tindakan yang dilakukan oleh TSPI_lineDial (misalnya, tidak ada pemutaran parsial, dan tidak ada offhook). Ini karena penyedia layanan harus memindai nomor untuk karakter yang tidak didukung terlebih dahulu.

TSPI_lineDial digunakan untuk memutar-balik pada tampilan panggilan yang ada; misalnya, handel panggilan yang dikembalikan dari TSPI_lineMakeCall dengan NULL sebagai lpszDestAddress atau berakhiran ';', handel panggilan yang dikembalikan dari TSPI_lineSetupTransfer atau TSPI_lineSetupConference. TSPI_lineDial dapat dipanggil beberapa kali selama panggilan dalam kasus panggilan multitahap, jika kemampuan perangkat baris mengizinkannya.

Jika string yang ditunjukkan oleh parameter lpszDestAddress dalam panggilan sebelumnya ke fungsi TSPI_lineMakeCall atau TSPI_lineDial dihentikan dengan titik koma, string kosong dalam panggilan saat ini ke TSPI_lineDial menunjukkan bahwa panggilan selesai.

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 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 diterima oleh penyedia layanan, bukan setelah panggilan akhirnya tersambung. Penyedia layanan yang menyediakan multipleks terbalik dapat memungkinkan beberapa alamat disediakan sekaligus. Penyedia layanan harus mengirim pesan LINE_CALLSTATE ke TAPI untuk menginformasikannya tentang kemajuan panggilan.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineMakeCall