lineSetAgentGroup 関数 (tapi.h)
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。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi.h |
Library | Tapi32.lib |
[DLL] | Tapi32.dll |