Struktur LINEAGENTCAPS (tapi.h)

Artikel
08/26/2023

Struktur LINEAGENTCAPS menjelaskan kemampuan agen ACD. Fungsi lineGetAgentCaps mengembalikan struktur LINEAGENTCAPS .

Sintaks

typedef struct lineagentcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwAgentHandlerInfoSize;
  DWORD dwAgentHandlerInfoOffset;
  DWORD dwCapsVersion;
  DWORD dwFeatures;
  DWORD dwStates;
  DWORD dwNextStates;
  DWORD dwMaxNumGroupEntries;
  DWORD dwAgentStatusMessages;
  DWORD dwNumAgentExtensionIDs;
  DWORD dwAgentExtensionIDListSize;
  DWORD dwAgentExtensionIDListOffset;
  GUID  ProxyGUID;
} LINEAGENTCAPS, *LPLINEAGENTCAPS;

Anggota

dwTotalSize

Ukuran total yang dialokasikan untuk struktur data ini, dalam byte.

dwNeededSize

Ukuran diperlukan untuk menyimpan semua informasi yang diminta, dalam byte.

dwUsedSize

Ukuran bagian dari struktur data ini yang berisi informasi yang berguna, dalam byte.

dwAgentHandlerInfoSize

Ukuran informasi handler agen, dalam byte.

dwAgentHandlerInfoOffset

Offset dari awal struktur ke string yang dihentikan null yang menentukan nama, versi, atau informasi identifikasi lain dari aplikasi server yang menangani permintaan agen. Ukuran string ditentukan oleh dwAgentHandlerInfoSize.

dwCapsVersion

Versi TAPI yang digunakan aplikasi handler agen dalam menyiapkan isi struktur ini. Ini tidak lebih besar dari versi API yang diteruskan aplikasi panggilan ke lineGetAgentCaps.

dwFeatures

Fitur terkait agen tersedia untuk baris ini menggunakan konstanta LINEAGENTFEATURE_. Memanggil fitur yang didukung mengharuskan baris dan alamat berada dalam status yang tepat. Nol dalam posisi bit menunjukkan bahwa fitur yang sesuai tidak pernah tersedia. Yang menunjukkan bahwa fitur yang sesuai mungkin tersedia jika baris dalam keadaan yang sesuai agar operasi menjadi bermakna. Bidang ini memungkinkan aplikasi untuk menemukan fitur agen mana yang dapat (dan yang tidak pernah dapat) didukung oleh perangkat.

dwStates

LINEAGENTSTATE_ konstanta yang dapat digunakan dalam parameter dwAgentState dari lineSetAgentState. Mengatur status yang didukung mengharuskan baris dan alamat berada dalam status yang tepat. Nol dalam posisi bit menunjukkan bahwa status yang sesuai tidak pernah tersedia. Yang menunjukkan bahwa status yang sesuai mungkin tersedia jika baris berada dalam status yang sesuai agar statusnya bermakna. Bidang ini memungkinkan aplikasi untuk menemukan status agen mana yang dapat (dan yang tidak pernah dapat) didukung pada perangkat.

dwNextStates

LINEAGENTSTATE_ konstanta yang dapat digunakan dalam parameter dwNextAgentState dari lineSetAgentState. Mengatur status yang didukung mengharuskan baris dan alamat berada dalam status yang tepat. Nol dalam posisi bit menunjukkan bahwa status yang sesuai tidak pernah tersedia. Yang menunjukkan bahwa status yang sesuai mungkin tersedia jika baris berada dalam status yang sesuai agar statusnya bermakna. Bidang ini memungkinkan aplikasi untuk menemukan status agen mana yang dapat (dan yang tidak pernah dapat) didukung pada perangkat.

dwMaxNumGroupEntries

Jumlah maksimum pengidentifikasi agen yang dapat masuk pada alamat secara bersamaan. Menentukan nilai tertinggi yang dapat diteruskan sebagai anggota dwNumEntries dalam struktur LINEAGENTGROUPLIST ke lineSetAgentGroup.

dwAgentStatusMessages

Menunjukkan konstanta LINEAGENTSTATUS_ yang dapat diterima oleh aplikasi di dwParam2 dari pesan LINE_AGENTSTATUS .

dwNumAgentExtensionIDs

Jumlah struktur LINEEXTENSIONID yang muncul di array ExtensionIDList . Nilainya adalah 0 jika ekstensi khusus penangan agen didukung pada alamat.

dwAgentExtensionIDListSize

Ukuran array ID ekstensi agen, dalam byte.

dwAgentExtensionIDListOffset

Offset dari awal struktur ke array struktur LINEEXTENSIONID . Ukurannya adalah dwNumExtensionIDs kali SIZEOF(LINEEXTENSIONID). Array mencantumkan pengidentifikasi unik universal 128-bit untuk semua ekstensi khusus penangan agen yang didukung oleh handel agen untuk alamat tersebut. Ekstensi yang digunakan direferensikan dalam fungsi lineAgentSpecific dan pesan LINE_AGENTSPECIFIC oleh posisinya dalam tabel ini, entri pertama adalah entri 0, jadi penting bahwa handler agen selalu menyajikan pengidentifikasi ekstensi dalam array ini dalam urutan yang sama. Ukuran array ditentukan oleh dwAgentExtensionIDListOffset.

ProxyGUID

GUID untuk proksi ACD yang terkait dengan baris. Elemen ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.2 atau lebih tinggi.