fungsi TSPI_lineSendUserUserInfo (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineSendUserUserInfo mengirimkan informasi pengguna-pengguna ke pihak jarak jauh pada panggilan yang ditentukan.

Sintaks

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

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Handel ke panggilan untuk mengirim informasi pengguna-pengguna. Status panggilan hdCall dapat dihubungkan, ditawarkan, diterima, atau dipanggil kembali.

lpsUserUserInfo

Penunjuk ke string Unicode yang dihentikan null yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh. Informasi pengguna hanya dikirim jika didukung oleh jaringan yang mendasarinya (lihat LINEDEVCAPS).

dwSize

Ukuran, dalam byte, termasuk terminator null , dari informasi pengguna di lpsUserUserInfo.

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_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Keterangan

Fungsi ini dapat digunakan untuk mengirim informasi pengguna-pengguna kapan saja selama panggilan tersambung. Jika ukuran informasi yang ditentukan untuk dikirim lebih besar dari apa yang dapat masuk ke dalam satu pesan jaringan (seperti dalam ISDN), penyedia layanan bertanggung jawab untuk memecah informasi menjadi urutan pesan jaringan berantai (menggunakan "lebih banyak data").

Informasi pengguna juga dapat dikirim sebagai bagian dari penerimaan panggilan, penolakan panggilan, pengalihan panggilan, dan saat melakukan panggilan. Informasi pengguna juga dapat diterima. Informasi yang diterima dilaporkan dalam struktur LINECALLINFO panggilan. Setiap kali informasi pengguna tiba setelah penawaran panggilan atau sebelum panggilan terputus, pesan LINE_CALLINFO dengan parameter UserUserInfo memberi tahu TAPI bahwa informasi pengguna dalam catatan informasi panggilan telah berubah. Jika beberapa pesan jaringan dirangkai, informasi dirakit oleh penyedia layanan dan satu pesan dikirim ke TAPI.