fungsi lineGetAddressCaps (tapi.h)

Artikel
03/04/2024

Fungsi lineGetAddressCaps meminta alamat yang ditentukan pada perangkat baris yang ditentukan untuk menentukan kemampuan teleponnya.

Sintaks

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parameter

hLineApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Perangkat baris yang berisi alamat yang akan dikueri.

dwAddressID

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

dwAPIVersion

Nomor versi API Telepon yang akan digunakan. Kata urutan tinggi berisi nomor versi utama; kata urutan rendah berisi nomor versi minor. Jumlah ini diperoleh oleh lineNegotiateAPIVersion.

dwExtVersion

Nomor versi ekstensi khusus penyedia layanan yang akan digunakan. Angka ini dapat diatur ke nol jika tidak ada ekstensi khusus perangkat yang akan digunakan. Jika tidak, kata urutan tinggi berisi nomor versi utama; dan kata urutan rendah berisi nomor versi minor.

lpAddressCaps

Penunjuk ke struktur tipe LINEADDRESSCAPS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan alamat. Sebelum memanggil lineGetAddressCaps, 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_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Keterangan

Pengidentifikasi alamat yang valid berkisar dari nol hingga satu kurang dari jumlah alamat yang dikembalikan oleh lineGetDevCaps. Nomor versi yang akan disediakan adalah nomor versi yang dikembalikan sebagai bagian dari kemampuan perangkat baris berdasarkan lineGetDevCaps.