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

ASYNC_COMPLETION

LINECALLINFO

LINE_CALLINFO

TSPI_lineGetCallInfo