共用方式為

lineGetAgentCapsA 函式 （tapi.h）

  • 發行項

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。

言論

注意

tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetAgentCaps 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 tapi.h
連結庫 Tapi32.lib
DLL Tapi32.dll

另請參閱

LINEAGENTCAPS

補充線路服務函式

TAPI 2.2 參考概觀

lineNegotiateAPIVersion