fungsi lineGetAgentCapsA (tapi.h)

Artikel
03/08/2023

Fungsi lineGetAgentCaps mendapatkan kemampuan terkait agen yang didukung pada perangkat baris yang ditentukan. Jika agen tertentu diberi nama, kemampuan tersebut mencakup daftar grup ACD tempat agen diizinkan untuk masuk.

Sintaks

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Parameter

hLineApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Perangkat baris yang berisi alamat yang akan dikueri.

dwAddressID

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

dwAppAPIVersion

Versi API tertinggi yang didukung oleh aplikasi. Ini seharusnya bukan nilai yang dinegosiasikan menggunakan lineNegotiateAPIVersion pada perangkat yang sedang dikueri.

lpAgentCaps

Penunjuk ke struktur tipe LINEAGENTCAPS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan agen. Sebelum memanggil lineGetAgentCaps, 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_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Keterangan

Catatan

Header tapi.h mendefinisikan lineGetAgentCaps 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.