fungsi lineGetAgentActivityListA (tapi.h)

Artikel
08/26/2023

Fungsi lineGetAgentActivityList mendapatkan identitas aktivitas yang dapat dipilih aplikasi menggunakan lineSetAgentActivity untuk menunjukkan fungsi apa yang sebenarnya dilakukan agen saat ini.

Sintaks

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

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.

lpAgentActivityList

Penunjuk ke struktur berukuran bervariasi dari jenis LINEAGENTACTIVITYLIST. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan daftar kode aktivitas agen yang dapat dipilih menggunakan lineSetAgentActivity. Sebelum memanggil lineGetAgentActivityList, aplikasi harus mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Menampilkan nilai

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

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

Keterangan

Catatan

Header tapi.h mendefinisikan lineGetAgentActivityList sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprossesor 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.