fungsi lineSendUserUserInfo (tapi.h)

Artikel
03/08/2023

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

Sintaks

LONG lineSendUserUserInfo(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parameter

hCall

Tangani panggilan untuk mengirim informasi pengguna-pengguna. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall harus terhubung, menawarkan, diterima, atau ringback.

lpsUserUserInfo

Penunjuk ke string yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh. Informasi pengguna hanya dikirim jika didukung oleh jaringan yang mendasarinya (lihat LINEDEVCAPS). Bidang diskriminator protokol untuk informasi pengguna-pengguna, jika diperlukan, akan muncul sebagai byte pertama dari buffer yang ditunjukkan oleh lpsUserUserInfo, dan harus diperbantukan dalam dwSize.

dwSize

Ukuran informasi pengguna di lpsUserUserInfo, dalam byte.

Menampilkan nilai

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

Keterangan

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

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

Fungsi ini dapat mengirim data melalui kabel dalam bentuk yang tidak terenkripsi; oleh karena itu, seseorang menguping pada jaringan mungkin dapat membaca data. Risiko keamanan pengiriman data dalam teks yang jelas harus dipertimbangkan sebelum menggunakan metode ini.