LINEAGENTCAPS 結構 (tapi.h)

發行項
03/02/2024

LINEAGENTCAPS 結構描述 ACD 代理程式的功能。 lineGetAgentCaps 函式會傳回 LINEAGENTCAPS 結構。

語法

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;

成員

dwTotalSize

配置給這個數據結構的大小總計，以位元組為單位。

dwNeededSize

以位元組為單位保存要求之所有資訊所需的大小。

dwUsedSize

這個數據結構中包含實用資訊的部分大小，以位元組為單位。

dwAgentHandlerInfoSize

代理程式處理程式資訊的大小，以位元組為單位。

dwAgentHandlerInfoOffset

從結構的開頭位移到以 Null 終止的字串，指定處理代理程式要求之伺服器應用程式的名稱、版本或其他識別資訊。字串的大小是由 dwAgentHandlerInfoSize 所指定。

dwCapsVersion

代理程式處理程式應用程式用於準備此結構內容的 TAPI 版本。這不大於呼叫應用程式傳入 lineGetAgentCaps的API版本。

dwFeatures

此行可使用 LINEAGENTFEATURE_常數的代理程序相關功能。叫用支援的功能需要行和地址處於適當的狀態。位位置中的零表示絕對無法使用對應的功能。一個表示如果行處於適當的狀態，則對應功能可能可供使用，以便讓作業有意義。此欄位可讓應用程式探索哪些代理程式功能可以 (，且永遠不會受到裝置支援) 。

dwStates

LINEAGENTSTATE_常數，可用於lineSetAgentState的 dwAgentState 參數。設定支援的狀態需要行和地址處於適當的狀態。位位置中的零表示對應狀態永遠無法使用。其中一個表示如果行處於適當狀態，則表示如果該行處於適當的狀態，則表示該狀態可能有意義。此欄位可讓應用程式探索哪些代理程式狀態可以 (，且永遠不會在裝置上) 支援。

dwNextStates

LINEAGENTSTATE_常數，可用於lineSetAgentState的 dwNextAgentState 參數。設定支援的狀態需要行和地址處於適當的狀態。位位置中的零表示對應狀態永遠無法使用。其中一個表示如果行處於適當狀態，則表示如果該行處於適當的狀態，則表示該狀態可能有意義。此欄位可讓應用程式探索哪些代理程式狀態可以 (，且永遠不會在裝置上) 支援。

dwMaxNumGroupEntries

可以同時登入位址的代理程式標識碼上限。決定可以當做 LINEAGENTGROUPLIST 結構中 dwNumEntries 成員傳遞至 lineSetAgentGroup 的最高值。

dwAgentStatusMessages

指出LINE_AGENTSTATUS訊息之 dwParam2 中的應用程式可以接收的LINEAGENTSTATUS_常數。

dwNumAgentExtensionIDs

ExtensionIDList 數位列中顯示的 LINEEXTENSIONID 結構數目。如果地址支援代理程式處理程式特定延伸模組，此值為 0。

dwAgentExtensionIDListSize

代理程式延伸模組識別碼陣列的大小，以位元組為單位。

dwAgentExtensionIDListOffset

從結構的開頭位移到 LINEEXTENSIONID 結構的陣列。此大小為 dwNumExtensionIDs sizeOF (LINEEXTENSIONID) 。數位列出位址代理程式句柄所支援之所有代理程式處理程式特定延伸模組的128位通用唯一標識碼。所使用的延伸模組會在 lineAgentSpecific 函式中參考，並依其在此數據表中的位置 LINE_AGENTSPECIFIC 訊息，第一個專案為專案 0，因此代理程式處理程式一律會以相同的順序顯示此陣列中的延伸模組標識符。陣列的大小是由 dwAgentExtensionIDListOffset 所指定。

ProxyGUID

與行相關聯的 ACD Proxy GUID。此元素只會公開給交涉 TAPI 版本 2.2 或更高版本的應用程式。