lineGetAgentActivityListA 函式 (tapi.h)

發行項
08/26/2023

lineGetAgentActivityList函式會取得應用程式可以使用lineSetAgentActivity選取的活動身分識別，以指出代理程式目前實際執行的函式。

語法

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

參數

hLine

開啟行裝置的控制碼。

dwAddressID

要查詢其代理程式狀態的開啟行裝置上的位址。位址識別碼永久與位址相關聯;識別碼在作業系統升級之間維持不變。

lpAgentActivityList

LINEAGENTACTIVITYLIST類型的可變大小結構的指標。成功完成要求時，此結構會填入可使用 lineSetAgentActivity選取的代理程式活動代碼清單。在呼叫 lineGetAgentActivityList之前，應用程式應該設定此結構的 dwTotalSize 成員，以指出 TAPI 可用的記憶體數量，以傳回信息。

傳回值

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

LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_INVALAGENTID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM LINEERR_UNINITIALIZED。