fungsi lineGetAgentCapsA (tapi.h)

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.

Sintaksis

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 tertentu 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 jenis yang bervariasi LINEAGENTCAPS. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan agen. Sebelum memanggil lineGetAgentCaps, aplikasi harus mengatur dwTotalSize anggota struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Mengembalikan 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.

Komentar

Nota

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

Persyaratan

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

Lihat juga

LINEAGENTCAPS

Fungsi Layanan Garis Tambahan

Gambaran Umum Referensi TAPI 2.2

lineNegotiateAPIVersion