lineSetAgentStateEx 函式 (tapi.h)
lineSetAgentStateEx函式會設定與特定代理程式控制碼相關聯的代理程式狀態。 它會產生 LINE_PROXYREQUEST訊息, 以傳送至已註冊的 Proxy 函式處理常式,參考類型為 LINEPROXYREQUEST_SETAGENTSTATEEX 的 LINEPROXYREQUEST 結構。
語法
LONG lineSetAgentStateEx(
HLINE hLine,
HAGENT hAgent,
DWORD dwAgentState,
DWORD dwNextAgentState
);
參數
hLine
線條裝置的控制碼。
hAgent
要變更其資訊之代理程式的識別碼。
dwAgentState
新的代理程式狀態。 必須是其中一 個LINEAGENTSTATEEX_常數或零,才能讓代理程式狀態保持不變,並只修改下一個狀態。
dwNextAgentState
下一個代理程式狀態。 必須是其中一個 LINEAGENTSTATEEX_常數 或零。
傳回值
如果非同步作業啟動時,傳回要求識別碼;否則,函式會傳回下列其中一個錯誤值:
LINEERR_INVALAGENTSTATE、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。
規格需求
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |