lineGetAgentCapsA 函式 (tapi.h)

發行項
08/26/2023

lineGetAgentCaps函式會取得指定之線路裝置上支援的代理程式相關功能。如果特定代理程式命名，這些功能會包含允許代理程式登入的 ACD 群組清單。

語法

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

參數

hLineApp

使用 TAPI 處理應用程式的註冊。

dwDeviceID

包含要查詢之位址的行裝置。

dwAddressID

要查詢其功能之指定行裝置上的位址。位址識別碼永久與位址相關聯;識別碼在作業系統升級之間維持不變。

dwAppAPIVersion

應用程式支援的最高 API 版本。這不應該是在查詢的裝置上使用 lineNegotiateAPIVersion 進行交涉的值。

lpAgentCaps

LINEAGENTCAPS類型的可變大小結構的指標。成功完成要求時，此結構會填入代理程式功能資訊。在呼叫 lineGetAgentCaps之前，應用程式應該設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回信息的記憶體數量。

傳回值

如果非同步作業啟動，則傳回正要求識別碼;否則，此函式會傳回下列其中一個負誤差值：

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。