lineGetAgentGroupListA 関数 (tapi.h)

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

lineGetAgentGroupList 関数は、現在ワークステーションにログインしているエージェントが自動呼び出しディストリビューターにログインできるエージェントグループ (キュー、スーパーバイザー、スキルレベルの組み合わせなど) の ID を取得します。

構文

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

パラメーター

hLine

開線デバイスへのハンドル。

dwAddressID

エージェントの状態を照会するオープンラインデバイスのアドレス。

lpAgentGroupList

LINEAGENTGROUPLIST 型の可変サイズの構造体へのポインター。要求が正常に完了すると、この構造体には、この時点でエージェントがログインできるエージェントグループの一覧が入力されます (エージェントが既にログインしているグループがある場合は、そのグループを含める必要があります)。

戻り値

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

LINEERR_INVALADDRESSID、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_UNINITIALIZED。

注釈

注意

tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetAgentGroupList を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。