fungsi lineGetNewCalls (tapi.h)

Fungsi lineGetNewCalls mengembalikan handel panggilan ke panggilan pada baris atau alamat tertentu yang saat ini tidak memiliki handel aplikasi. Aplikasi diberikan hak istimewa monitor untuk panggilan ini.

Sintaks

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

Parameter

hLine

Menangani ke perangkat baris terbuka.

dwAddressID

Alamat pada perangkat baris terbuka yang diberikan. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

dwSelect

Pemilihan panggilan yang diminta. Parameter ini menggunakan satu dan hanya satu dari konstanta LINECALLSELECT_.

lpCallList

Penunjuk ke struktur data berukuran varian jenis LINECALLLIST. Setelah berhasil menyelesaikan permintaan, handel panggilan ke semua panggilan yang dipilih dikembalikan dalam struktur ini. Sebelum memanggil lineGetNewCalls, 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 .

 

Mengembalikan nilai

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

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Keterangan

Aplikasi dapat menggunakan lineGetNewCalls untuk mendapatkan handel ke panggilan yang saat ini tidak memiliki handel. Aplikasi dapat memilih panggilan yang handelnya akan dikembalikan dengan mendamaikan pilihan ini pada cakupan (panggilan pada baris tertentu, atau panggilan pada alamat tertentu). Misalnya, aplikasi dapat meminta handel panggilan ke semua panggilan pada alamat tertentu yang saat ini tidak memiliki handel. Aplikasi selalu diberikan hak istimewa monitor untuk handel panggilan baru. Selain itu, saat membuka baris, aplikasi menggunakan fungsi ini untuk mengetahui panggilan yang ada.

Aplikasi dapat memanggil lineGetCallInfo dan lineGetCallStatus untuk setiap panggilan dalam daftar untuk menentukan informasi dan status panggilan. Ini dapat menggunakan lineSetCallPrivilege untuk mengubah hak istimewanya kepada pemilik.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

Referensi Layanan Telepon Dasar

LINECALLLIST

Gambaran Umum Referensi TAPI 2.2

lineGetCallInfo

lineGetCallStatus

lineSetCallPrivilege