fungsi TSPI_lineRedirect (tspi.h)

Artikel
03/03/2024

Fungsi TSPI_lineRedirect mengalihkan panggilan penawaran yang ditentukan ke alamat tujuan yang ditentukan.

Sintaks

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

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Handel ke panggilan yang akan dialihkan. Status panggilan hdCall dapat ditawarkan.

lpszDestAddress

Penunjuk ke string Unicode yang dihentikan null yang menentukan alamat tujuan. Ini mengikuti format tautan standar.

dwCountryCode

Kode negara atau wilayah pihak tempat panggilan dialihkan. Jika nilai 0 ditentukan, default digunakan oleh implementasi. Parameter ini tidak divalidasi oleh TAPI 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_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.

Keterangan

Penyedia layanan tidak mengalihkan panggilan jika mengembalikan LINEERR_INVALADDRESS.

Ketika fungsi ini dipanggil, penyedia layanan menangguhkan panggilan penawaran ke alamat lain tanpa terlebih dahulu menjawab panggilan. Pengalihan panggilan berbeda dari pengalihan panggilan dalam pengalihan panggilan tersebut dilakukan oleh pengalihan tanpa keterlibatan stasiun yang dipanggil; pengalihan dapat dilakukan berdasarkan panggilan demi panggilan oleh aplikasi klien, misalnya didorong oleh informasi ID penelepon. Ini berbeda dari transfer panggilan dalam transfer panggilan mengharuskan panggilan dijawab terlebih dahulu.

Setelah panggilan berhasil dialihkan, panggilan biasanya beralih ke diam. Penyedia layanan menunjukkan status baru menggunakan pesan LINE_CALLSTATE .