fungsi TSPI_lineCompleteCall (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineCompleteCall digunakan untuk menentukan bagaimana panggilan yang tidak dapat dihubungkan secara normal akan diselesaikan sebagai gantinya. Jaringan atau sakelar mungkin tidak dapat menyelesaikan panggilan karena sumber daya jaringan sibuk atau stasiun jarak jauh sibuk atau tidak menjawab.

Sintaks

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Penanganan penyedia layanan ke panggilan yang penyelesaiannya diminta. Status panggilan hdCall bisa sibuk, ringback, atau melanjutkan.

lpdwCompletionID

Pointer ke lokasi memori berukuran DWORD tempat penyedia layanan menulis pengidentifikasi penyelesaian. Ini secara unik mengidentifikasi permintaan penyelesaian yang sedang berlangsung pada baris yang berisi hdCall. Secara khusus, pengidentifikasi penyelesaian menjadi tidak valid setelah permintaan selesai atau dibatalkan menggunakan fungsi TSPI_lineUncompleteCall . Penyedia layanan bebas menggunakan kembali pengidentifikasi penyelesaian segera setelah menjadi tidak valid.

dwCompletionMode

Cara panggilan akan diselesaikan. Parameter ini menggunakan satu dan hanya satu dari konstanta LINECALLCOMPLMODE_.

dwMessageID

Pesan yang akan dikirim saat menyelesaikan panggilan menggunakan LINECALLCOMPLMODE_MESSAGE. Pengidentifikasi ini memilih pesan dari sejumlah kecil pesan yang telah ditentukan sebelumnya. Parameter ini tidak divalidasi oleh TAPI ketika fungsi ini dipanggil.

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_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLCOMPLMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_COMPLETIONOVERRUN, LINEERR_INVALMESSAGEID.

Keterangan

Fungsi ini dianggap selesai ketika permintaan diterima oleh jaringan atau sakelar; bukan ketika permintaan sepenuhnya selesai dengan cara yang ditentukan. Ketika stasiun atau jaringan yang dipanggil memasuki status di mana panggilan dapat diselesaikan seperti yang diminta, penyedia layanan harus mengirim pesan LINE_CALLSTATE dengan status panggilan yang sama dengan penawaran. Catatan LINECALLINFO panggilan mencantumkan alasan panggilan sebagai CALLCOMPLETION dan menyediakan pengidentifikasi penyelesaian juga. Dimungkinkan untuk memiliki beberapa permintaan penyelesaian panggilan yang terutang pada waktu tertentu; jumlah maksimum tergantung pada perangkat. Pengidentifikasi penyelesaian juga digunakan untuk merujuk ke setiap permintaan individu sehingga permintaan dapat dibatalkan dengan memanggil TSPI_lineUncompleteCall.