fungsi TSPI_lineBlindTransfer (tspi.h)

  • Artikel

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

Sintaks

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

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Handel penyedia layanan ke panggilan yang akan ditransfer. Status panggilan hdCall dapat dihubungkan.

lpszDestAddress

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi ke mana panggilan akan ditransfer. Alamat tujuan menggunakan format nomor yang dapat dialihkan standar.

dwCountryCode

Kode negara atau wilayah tujuan. Implementasi harus menggunakan ini untuk memilih protokol kemajuan panggilan untuk alamat tujuan. Jika nilai 0 ditentukan, penyedia layanan harus menggunakan default. TAPI tidak memvalidasi dwCountryCode 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_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE.

Keterangan

Penyedia layanan tidak melakukan panggilan jika kembali LINEERR_INVALADDRESS.

Transfer buta berbeda dari transfer konsultasi karena tidak ada panggilan konsultasi yang dibuat terlihat oleh TAPI. Biasanya, setelah transfer buta berhasil diselesaikan, panggilan yang ditentukan dibersihkan dari baris yang aktif dan transisi ke status diam . Handel panggilan penyedia layanan harus tetap valid setelah transfer selesai. TAPI menyebabkan handel ini tidak valid ketika tidak lagi tertarik dengan panggilan yang ditransfer menggunakan TSPI_lineCloseCall.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineCloseCall