fungsi TSPI_lineCloseCall (tspi.h)

Fungsi TSPI_lineCloseCall membatalkan alokasi panggilan setelah menyelesaikan atau membatalkan semua operasi asinkron yang luar biasa pada panggilan.

Sintaks

LONG TSPIAPI TSPI_lineCloseCall(
  HDRVCALL hdCall
);

Parameter

hdCall

Pegangan penyedia layanan ke panggilan yang akan ditutup. Setelah panggilan berhasil ditutup, handel ini tidak lagi valid. Status panggilan dapat menjadi status apa pun.

Nilai kembali

Mengembalikan nol jika fungsi berhasil atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Keterangan

Penyedia layanan harus melaporkan penyelesaian untuk operasi asinkron. Jika TSPI_lineCloseCall dipanggil untuk panggilan di mana ada operasi asinkron yang luar biasa, operasi harus dilaporkan lengkap dengan hasil atau kode kesalahan yang sesuai sebelum prosedur ini kembali. Setelah prosedur ini kembali, penyedia layanan harus melaporkan tidak ada peristiwa lebih lanjut pada panggilan. Handel penyedia layanan untuk baris dan panggilan pada baris menjadi "tidak valid."

TAPI tidak memanggil TSPI_lineCloseCall jika penyedia layanan secara sinkron mengembalikan kesalahan dari panggilan ke fungsi TSPI_lineMakeCall . Tetapi TAPI memanggil TSPI_lineCloseCall jika penyedia layanan mengembalikan kesalahan dari operasi asinkron yang dimulai oleh TSPI_lineMakeCall.

Jika ada panggilan aktif pada baris pada saat TSPI_lineCloseCall, panggilan harus dihilangkan jika perilaku ini ditunjukkan oleh bit LINEDEVCAPFLAGS_CLOSEDROP dalam struktur LINEDEVCAPS .

Jika penyedia layanan dapat menentukan bahwa ada kontrol berbagi agen lain dari panggilan, seperti dalam situasi baris pihak dengan handset terpisah, penyedia layanan hanya memungkinkan kontrol panggilan yang diteruskan ke agen lain daripada menjatuhkannya secara paksa.

Fungsi ini harus selalu berhasil kecuali dalam keadaan luar biasa. Sebagian besar penelepon mungkin akan mengabaikan kode pengembalian karena mereka tidak akan dapat mengimbangi kesalahan apa pun yang terjadi. Nilai pengembalian yang ditentukan lebih menjadi saran untuk tujuan diagnostik pengembangan daripada yang lain.

Fungsi ini dipanggil ketika aplikasi terakhir dengan handel untuk panggilan ini menjalankan lineDeallocateCall.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

LINEDEVCAPS

TSPI_lineMakeCall