lineSetAgentSessionState 函式 (tapi.h)

lineSetAgentSessionState 函式會設定與特定代理程式會話句柄相關聯的代理程式會話狀態。 它會產生要傳送至已註冊 Proxy 函式處理程式 的LINE_PROXYREQUEST 訊息,參考類型為 LINEPROXYREQUEST_SETAGENTSESSIONSTATE 的 LINEPROXYREQUEST 結構。

語法

LONG lineSetAgentSessionState(
  HLINE         hLine,
  HAGENTSESSION hAgentSession,
  DWORD         dwAgentSessionState,
  DWORD         dwNextAgentSessionState
);

參數

hLine

線條裝置的句柄。

hAgentSession

要變更其資訊的代理程式會話標識碼。

dwAgentSessionState

新的代理程式會話狀態。 必須是其中一個 LINEAGENTSESSIONSTATE_常數 或零,才能讓代理程式會話狀態保持不變,並只修改下一個狀態。

dwNextAgentSessionState

下一個代理程式會話狀態。 必須是其中一個 LINEAGENTSESSIONSTATE_常數 或零。

傳回值

如果異步操作啟動時,會傳回要求標識符;否則,函式會傳回下列其中一個錯誤值:

LINEERR_INVALAGENTSTATE、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。

規格需求

需求
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

關於通話中心控件

LINEAGENTSESSIONSTATE_常數

LINEPROXYREQUEST

LINE_PROXYREQUEST