fungsi lineGetAddressStatus (tapi.h)

Artikel
03/02/2024

Fungsi lineGetAddressStatus memungkinkan aplikasi untuk mengkueri alamat yang ditentukan untuk statusnya saat ini.

Sintaks

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Parameter

hLine

Tangani ke perangkat baris terbuka.

dwAddressID

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

lpAddressStatus

Penunjuk ke struktur data berukuran bervariasi dari jenis LINEADDRESSSTATUS. Sebelum memanggil lineGetAddressStatus, 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_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

Persyaratan

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

Lihat juga

Referensi Layanan Telepon Dasar

LINEADDRESSSTATUS

Gambaran Umum Referensi TAPI 2.2

Bagikan melalui