fungsi lineRedirect (tapi.h)
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tapi.h |
Pustaka | Tapi32.lib |
DLL | Tapi32.dll |