fungsi lineRedirect (tapi.h)

Artikel
03/04/2024

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

Sintaks

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

Parameter

hCall

Tangani ke panggilan yang akan dialihkan. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall harus ditawarkan.

lpszDestAddress

Arahkan ke alamat tujuan. Ini mengikuti format nomor dialable standar.

dwCountryCode

Kode negara/wilayah pihak tempat panggilan dialihkan. Jika nilai 0 ditentukan, default digunakan oleh implementasi.

Nilai kembali

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_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Keterangan

Pengalihan panggilan memungkinkan aplikasi untuk 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 aplikasi; pengalihan dapat dilakukan berdasarkan panggilan demi panggilan oleh aplikasi, 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.

Selain mengalihkan panggilan masuk, aplikasi mungkin memiliki opsi untuk menerima panggilan menggunakan lineAccept, menolak panggilan menggunakan lineDrop, atau menjawab panggilan menggunakan lineAnswer. Ketersediaan operasi ini tergantung pada kemampuan perangkat.