fungsi lineGetAddressID (tapi.h)

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.

 

Persyaratan

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

Lihat juga

Referensi Layanan Telepon Dasar

Gambaran Umum Referensi TAPI 2.2

lineMakeCall