lineSetAgentState 函式 (tapi.h)
lineSetAgentState 函式會設定與特定地址相關聯的代理程序狀態。
語法
LONG lineSetAgentState(
HLINE hLine,
DWORD dwAddressID,
DWORD dwAgentState,
DWORD dwNextAgentState
);
參數
hLine
線條裝置的句柄。
dwAddressID
要變更代理程式資訊之位址的標識碼。 位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。
dwAgentState
新的代理程序狀態。 必須是其中一個 LINEAGENTSTATE_常數或零，才能讓代理程序狀態保持不變，並只修改下一個狀態。
dwNextAgentState
當位址上的目前呼叫變成 閑置時，應該自動設定的代理程序狀態。 例如，如果已知必須執行呼叫後工作，可以將此欄位設定為 LINEAGENTSTATE_WORKAFTERCALL，以便在目前的呼叫之後，不會將新的呼叫指派給代理程式。 必須是其中一個 LINEAGENTSTATE_常數，或零，才能使用為代理程式設定的預設下一個狀態。
傳回值
如果異步操作啟動時，會傳回正要求標識符;否則，函式會傳回下列其中一個負誤差值：
LINEERR_INVALADDRESSID、LINEERR_INVALADDRESSSTATE、LINEERR_INVALAGENTSTATE、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |