fungsi lineCompleteCall (tapi.h)

Artikel
03/08/2023

Fungsi lineCompleteCall menentukan bagaimana panggilan yang tidak dapat dihubungkan secara normal harus diselesaikan sebagai gantinya. Jaringan atau sakelar mungkin tidak dapat menyelesaikan panggilan karena sumber daya jaringan sibuk atau stasiun jarak jauh sibuk atau tidak menjawab. Aplikasi dapat meminta agar panggilan selesai dengan salah satu dari sejumlah cara.

Sintaks

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

Parameter

hCall

Tangani panggilan yang penyelesaiannya diminta. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall harus sibuk atau ringback.

lpdwCompletionID

Penunjuk ke lokasi memori berukuran DWORD. Pengidentifikasi penyelesaian digunakan untuk mengidentifikasi permintaan penyelesaian individu yang sedang berlangsung. Pengidentifikasi penyelesaian menjadi tidak valid dan dapat digunakan kembali setelah permintaan selesai atau setelah permintaan yang terutang dibatalkan.

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.

Mengembalikan 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_COMPLETIONOVERRUN, LINEERR_NOMEM, LINEERR_INVALCALLCOMPLMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMESSAGEID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.

Keterangan

Fungsi ini dianggap selesai ketika permintaan telah diterima oleh jaringan atau sakelar; bukan ketika permintaan sepenuhnya selesai dengan cara yang ditentukan. Setelah fungsi ini selesai, panggilan biasanya beralih ke diam. Ketika stasiun atau jaringan yang dipanggil memasuki status di mana panggilan dapat diselesaikan seperti yang diminta, aplikasi diberi tahu oleh pesan LINE_CALLSTATE dengan status panggilan yang sama dengan penawaran. Catatan LINECALLINFO panggilan mencantumkan alasan panggilan sebagai CALLCOMPLETION dan juga menyediakan pengidentifikasi penyelesaian. Dimungkinkan untuk memiliki beberapa permintaan penyelesaian panggilan yang luar biasa; jumlah maksimum tergantung pada perangkat. Pengidentifikasi penyelesaian juga digunakan untuk merujuk ke setiap permintaan individu sehingga permintaan dapat dibatalkan dengan memanggil lineUncompleteCall.