fungsi TSPI_lineGetAddressID (tspi.h)

  • Artikel

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

Sintaks

LONG TSPIAPI TSPI_lineGetAddressID(
  HDRVLINE hdLine,
  LPDWORD  lpdwAddressID,
  DWORD    dwAddressMode,
  LPCWSTR  lpsAddress,
  DWORD    dwSize
);

Parameter

hdLine

Handel penyedia layanan ke baris yang alamatnya akan diambil.

lpdwAddressID

Penunjuk ke lokasi memori berukuran DWORD tempat pengidentifikasi alamat dikembalikan.

dwAddressMode

Mode alamat alamat yang terkandung dalam lpsAddress. Parameter dwAddressMode diizinkan untuk memiliki satu dan hanya satu dari konstanta LINEADDRESSMODE_.

lpsAddress

Penunjuk ke struktur data yang menyimpan alamat yang ditetapkan ke perangkat baris yang ditentukan. Format alamat ditentukan oleh parameter dwAddressMode . Jika LINEADDRESSMODE_DIALABLEADDR, parameter lpsAddress menggunakan format angka yang dapat dialihkan umum dan NULL dihentikan.

dwSize

Ukuran alamat yang terkandung dalam lpsAddress. Parameter dwSize harus diatur ke panjang string (ditambah satu untuk NULL) jika LINEADDRESSMODE_DIALABLEADDR digunakan. Jika LINEADDRESSMODE yang diperluas digunakan, panjangnya harus sesuai dengan ukuran apa pun yang benar-benar diteruskan (DLL memeriksa untuk memastikannya dapat membaca jumlah byte yang ditentukan dari penunjuk yang diberikan).

Nilai kembali

Mengembalikan nol jika fungsi berhasil atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Fungsi ini digunakan untuk memetakan nomor telepon (alamat) yang ditetapkan ke perangkat baris kembali ke dwAddressID-nya (dalam rentang 0 hingga jumlah alamat dikurangi satu) yang dikembalikan dalam kemampuan perangkat baris.

Persyaratan

   
Target Platform Windows
Header tspi.h

Lihat juga

Konstanta LINEADDRESSMODE_