fungsi lineGetAgentStatusA (tapi.h)

Artikel
03/02/2024

Fungsi lineGetAgentStatus mendapatkan status terkait agen pada alamat yang ditentukan.

Sintaks

LONG lineGetAgentStatusA(
  HLINE             hLine,
  DWORD             dwAddressID,
  LPLINEAGENTSTATUS lpAgentStatus
);

Parameter

hLine

Tangani ke perangkat baris terbuka.

dwAddressID

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

lpAgentStatus

Penunjuk ke struktur tipe LINEAGENTSTATUS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi status agen. Sebelum memanggil lineGetAgentStatus, 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 memori bisa ditimpa. Untuk informasi selengkapnya tentang pengaturan ukuran struktur, lihat topik alokasi memori .

Nilai kembali

Mengembalikan pengidentifikasi permintaan positif jika operasi asinkron dimulai; jika tidak, salah satu nilai kesalahan negatif ini:

LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Keterangan

Catatan

Header tapi.h mendefinisikan lineGetAgentStatus sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.