lineGetAgentActivityListW 函式 (tapi.h)

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

語法

LONG lineGetAgentActivityListW(
  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。