TSPI_lineAnswer (tspi.h)

Artikel
03/03/2024

Fungsi TSPI_lineAnswer menjawab panggilan penawaran yang ditentukan.

Sintaks

LONG TSPIAPI TSPI_lineAnswer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Pegangan penyedia layanan ke panggilan yang akan dijawab. Status panggilan hdCall dapat ditawarkan atau diterima.

lpsUserUserInfo

Penunjuk ke string yang dihentikan null yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh pada saat menjawab panggilan. Jika pointer ini NULL, itu menunjukkan bahwa tidak ada informasi pengguna-pengguna yang akan dikirim. Informasi pengguna hanya dikirim jika didukung oleh jaringan yang mendasarinya (seperti yang ditunjukkan dalam LINEDEVCAPS).

dwSize

Ukuran dalam byte informasi pengguna-pengguna di lpsUserUserInfo. Jika lpsUserUserInfo adalah NULL, dwSize diabaikan.

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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INUSE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG.

Keterangan

Ketika panggilan baru tiba, penyedia layanan mengirim TAPI pesan LINE_NEWCALL untuk bertukar handel untuk panggilan. Penyedia layanan mengikuti ini dengan pesan LINE_CALLSTATE untuk memberi tahu TAPI dan aplikasi kliennya tentang status panggilan. Aplikasi klien biasanya menjawab panggilan menggunakan TSPI_lineAnswer. Biasanya, setelah panggilan berhasil dijawab, panggilan beralih ke status tersambung .

Di beberapa lingkungan telepon (seperti ISDN) di mana pemberitahuan pengguna terpisah dari penawaran panggilan, TAPI dan aplikasi kliennya mungkin memiliki opsi untuk terlebih dahulu menerima panggilan sebelum menjawab, atau sebaliknya menolak atau mengalihkan panggilan penawaran .

Jika panggilan ditawarkan pada saat panggilan lain sudah aktif, panggilan baru tersambung dengan memanggil TSPI_lineAnswer. Efek ini pada panggilan aktif yang ada tergantung pada kemampuan perangkat baris. Panggilan pertama mungkin tidak terpengaruh, mungkin secara otomatis dihentikan, atau mungkin secara otomatis ditangguhkan. Pesan LINE_CALLSTATE yang sesuai digunakan untuk melaporkan transisi status ke TAPI tentang kedua panggilan.