fungsi lineGetCallStatus (tapi.h)

Artikel
08/26/2023

Fungsi lineGetCallStatus mengembalikan status panggilan yang ditentukan saat ini.

Sintaks

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Parameter

hCall

Tangani ke panggilan yang akan dikueri. Status panggilan hCall dapat menjadi status apa pun.

lpCallStatus

Penunjuk ke struktur data berukuran bervariasi dari jenis LINECALLSTATUS. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi status panggilan. Sebelum memanggil lineGetCallStatus, aplikasi harus mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Catatan Jika parameter ukuran dalam struktur tidak benar, ada kemungkinan data bisa ditimpa. Untuk informasi selengkapnya tentang pengaturan ukuran struktur, lihat topik alokasi memori .

Menampilkan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Keterangan

Fungsi lineGetCallStatus mengembalikan status dinamis panggilan, sedangkan lineGetCallInfo mengembalikan informasi statis terutama tentang panggilan. Informasi status panggilan mencakup status panggilan saat ini, informasi mode terperinci yang terkait dengan panggilan saat dalam status ini (jika ada), serta daftar fungsi API yang tersedia yang dapat dipanggil aplikasi pada panggilan saat panggilan berada dalam status ini. Aplikasi biasanya akan tertarik untuk meminta informasi ini ketika menerima pemberitahuan tentang perubahan status panggilan oleh pesan LINE_CALLSTATE.