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

另請參閱

增補行服務函式

TAPI 2.2 參考概觀