TSPI_lineReleaseUserUserInfo (tspi.h)
Fungsi TSPI_lineReleaseUserUserInfo memberi tahu penyedia layanan bahwa informasi pengguna-pengguna yang terkandung dalam struktur LINECALLINFO telah diproses, dan informasi pengguna yang kemudian diterima sekarang dapat ditulis ke dalam struktur tersebut. Penyedia layanan mengirim pesan LINE_CALLINFO yang menunjukkan LINECALLINFOSTATE_USERUSERINFO saat informasi baru tersedia.
Sintaks
LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parameter
dwRequestID
Pengidentifikasi permintaan asinkron.
hdCall
Pegangan penyedia layanan terhadap panggilan yang informasi pengguna-penggunanya akan dirilis. Status panggilan hdCall bisa apa saja.
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_NOMEM, LINEERR_RESOURCEUNAVAIL.
Keterangan
Fungsi TSPI_lineReleaseUserUserInfo memungkinkan kontrol alur informasi pengguna-pengguna masuk pada koneksi ISDN. Ketika pesan informasi pengguna baru dan lengkap diterima, penyedia layanan menginformasikan TAPI menggunakan pesan LINE_CALLINFO (menentukan LINECALLINFOSTATE_USERUSERINFO). Informasi pengguna dan bidang lain di LINECALLINFO dapat diperiksa dengan beberapa panggilan ke TSPI_lineGetCallInfo. Penyedia layanan tidak boleh menimpa informasi pengguna-pengguna sebelumnya di LINECALLINFO dengan informasi yang lebih baru sampai setelah TSPI_lineReleaseUserUserInfo dipanggil. Penyedia layanan harus buffer kemudian menerima informasi pengguna-pengguna sampai informasi sebelumnya dirilis. Informasi buffer yang tersisa dapat dibuang saat TSPI_lineCloseCall dipanggil.
Jika fungsi ini dipanggil sementara tidak ada informasi pengguna-pengguna di LINECALLINFO, penyedia layanan tetap harus mengembalikan indikasi keberhasilan.
Untuk kompatibilitas mundur, TAPI secara otomatis mengembalikan LINEERR_OPERATIONUNAVAIL jika fungsi ini dipanggil untuk panggilan pada baris di bawah kendali penyedia layanan yang tidak mengekspor fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tspi.h |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk