fungsi lineGetAddressID (tapi.h)

Artikel
08/26/2023

Fungsi lineGetAddressID mengembalikan pengidentifikasi alamat yang terkait dengan alamat dalam format yang berbeda pada baris yang ditentukan.

Sintaks

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Parameter

hLine

Tangani ke perangkat baris terbuka.

lpdwAddressID

Penunjuk ke lokasi memori berukuran DWORD tempat pengidentifikasi alamat dikembalikan. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

dwAddressMode

Mode alamat alamat yang terkandung dalam lpsAddress. Parameter ini menggunakan satu dan hanya satu dari konstanta LINEADDRESSMODE_. Anda harus menentukan LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Penunjuk ke struktur data yang menyimpan alamat yang ditetapkan ke perangkat baris yang ditentukan. Format alamat ditentukan oleh dwAddressMode. Karena satu-satunya nilai yang valid adalah LINEADDRESSMODE_DIALABLEADDR, lpsAddress menggunakan format angka yang dapat dialihkan umum dan dihentikan null.

dwSize

Ukuran, dalam byte, dari alamat yang terkandung dalam lpsAddress. Ukuran string harus menyertakan terminator null.

Mengembalikan nilai

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Keterangan

Fungsi lineGetAddressID digunakan untuk memetakan nomor telepon (alamat) yang ditetapkan ke perangkat baris kembali ke dwAddressID dalam rentang nol hingga jumlah alamat dikurangi satu yang dikembalikan dalam kemampuan perangkat baris. Fungsi lineMakeCall memungkinkan aplikasi untuk melakukan panggilan dengan menentukan handel baris dan alamat di baris. Alamat dapat ditentukan sebagai dwAddressID, sebagai nomor telepon, atau sebagai nama atau pengidentifikasi khusus perangkat. Menggunakan nomor telepon bisa praktis di lingkungan di mana satu baris diberi beberapa alamat.

Catatan LINEADDRESSMODE_ADDRESSID mungkin tidak digunakan dengan lineGetAddressID.