lineSetAgentState 関数 (tapi.h)

lineSetAgentState 関数は、特定のアドレスに関連付けられているエージェントの状態を設定します。

構文

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

パラメーター

hLine

ライン デバイスへのハンドル。

dwAddressID

エージェント情報を変更するアドレスの識別子。 アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティング システムのアップグレード間で一定のままです。

dwAgentState

新しいエージェントの状態。 エージェントの状態を変更せずに次の状態のみを変更するには、 LINEAGENTSTATE_定数のいずれか、または 0 である必要があります。

dwNextAgentState

アドレスの現在の呼び出しが アイドル状態になったときに自動的に設定する必要があるエージェントの状態。 たとえば、呼び出し後の作業を実行する必要があることがわかっている場合は、このフィールドをLINEAGENTSTATE_WORKAFTERCALLに設定して、現在の呼び出しの後に新しい呼び出しがエージェントに割り当てられないようにすることができます。 エージェントに対して構成された既定の次の状態を使用するには、 LINEAGENTSTATE_定数のいずれか、または 0 である必要があります。

戻り値

非同期操作が開始された場合は、正の要求識別子を返します。それ以外の場合、関数は次のいずれかの負のエラー値を返します。

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

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	tapi.h
Library	Tapi32.lib
[DLL]	Tapi32.dll

こちらもご覧ください

補助回線サービス関数

TAPI 2.2 リファレンスの概要