fungsi lineGetCallInfo (tapi.h)

Artikel
03/13/2024

Fungsi lineGetCallInfo memungkinkan aplikasi untuk mendapatkan informasi tetap tentang panggilan yang ditentukan.

Sintaks

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Parameter

hCall

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

lpCallInfo

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

Nilai kembali

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

Struktur LINECALLINFO terpisah ada untuk setiap panggilan masuk atau keluar. Struktur berisi terutama informasi tetap tentang panggilan. Aplikasi biasanya akan tertarik untuk memeriksa informasi ini ketika menerima handelnya untuk panggilan oleh pesan LINE_CALLSTATE , atau setiap kali menerima pemberitahuan oleh pesan LINE_CALLINFO bahwa bagian dari struktur informasi panggilan telah berubah. Pesan-pesan ini menyediakan handel untuk panggilan sebagai parameter.