lineSetAgentGroup 関数 (tapi.h)

[アーティクル]
03/05/2024

lineSetAgentGroup 関数は、エージェントが特定のアドレスにログインするエージェントグループを設定します。

構文

LONG lineSetAgentGroup(
  HLINE                hLine,
  DWORD                dwAddressID,
  LPLINEAGENTGROUPLIST lpAgentGroupList
);

パラメーター

hLine

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

dwAddressID

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

lpAgentGroupList

現在のエージェントがアドレスにログインするグループを識別する LINEAGENTGROUPLIST 構造体へのポインター。ポインターが NULL であるか、指定された構造体内のグループ数が 0 の場合、エージェントは現在ログインしている ACD グループからログアウトされます。

この関数の目的で、リスト内の LINEAGENTGROUPENTRY 項目の "名前" フィールドは無視されます。ログイングループの制御は、グループ識別子の値のみに基づいています。

戻り値

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

LINEERR_INVALADDRESSID、LINEERR_INVALADDRESSSTATE、LINEERR_INVALAGENTGROUP、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_INVALPASSWORD、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。