fungsi lineBlindTransfer (tapi.h)

Artikel
03/08/2023

Fungsi lineBlindTransfer melakukan transfer buta atau satu langkah dari panggilan yang ditentukan ke alamat tujuan yang ditentukan.

Sintaks

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

Parameter

hCall

Tangani ke panggilan yang akan ditransfer. Aplikasi harus menjadi pemilik panggilan ini. Status panggilan hCall harus tersambung.

lpszDestAddress

TBD

dwCountryCode

Kode negara atau wilayah tujuan. Ini digunakan oleh implementasi untuk memilih protokol kemajuan panggilan untuk alamat tujuan. Jika nilai 0 ditentukan, protokol kemajuan panggilan default yang ditentukan oleh penyedia layanan akan digunakan.

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_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Keterangan

Jika LINEERR_INVALADDRESS dikembalikan, tidak ada panggilan yang terjadi.

Transfer buta berbeda dari transfer konsultasi karena tidak ada panggilan konsultasi yang dibuat terlihat oleh aplikasi. Setelah transfer buta berhasil diselesaikan, panggilan yang ditentukan biasanya dibersihkan dari baris aplikasi, dan bertransisi ke status menganggur .

Handel panggilan aplikasi tetap valid setelah transfer selesai. Aplikasi harus membatalkan alokasi handelnya menggunakan lineDeallocateCall ketika tidak lagi tertarik dengan panggilan yang ditransfer.