LINEPROXYREQUEST 構造体 (tapi.h)
LINEPROXYREQUEST 構造体には、プロキシ要求を行うアプリケーションのパラメーター値が含まれています。 複数の TAPI コール センター関数は、LINEPROXYREQUEST 構造体を参照するLINE_PROXYREQUEST メッセージを生成します。
構文
typedef struct lineproxyrequest_tag {
DWORD dwSize;
DWORD dwClientMachineNameSize;
DWORD dwClientMachineNameOffset;
DWORD dwClientUserNameSize;
DWORD dwClientUserNameOffset;
DWORD dwClientAppAPIVersion;
DWORD dwRequestType;
union {
struct {
DWORD dwAddressID;
LINEAGENTGROUPLIST GroupList;
} SetAgentGroup;
struct {
DWORD dwAddressID;
DWORD dwAgentState;
DWORD dwNextAgentState;
} SetAgentState;
struct {
DWORD dwAddressID;
DWORD dwActivityID;
} SetAgentActivity;
struct {
DWORD dwAddressID;
LINEAGENTCAPS AgentCaps;
} GetAgentCaps;
struct {
DWORD dwAddressID;
LINEAGENTSTATUS AgentStatus;
} GetAgentStatus;
struct {
DWORD dwAddressID;
DWORD dwAgentExtensionIDIndex;
DWORD dwSize;
BYTE Params[1];
} AgentSpecific;
struct {
DWORD dwAddressID;
LINEAGENTACTIVITYLIST ActivityList;
} GetAgentActivityList;
struct {
DWORD dwAddressID;
LINEAGENTGROUPLIST GroupList;
} GetAgentGroupList;
struct {
HAGENT hAgent;
DWORD dwAgentIDSize;
DWORD dwAgentIDOffset;
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
} CreateAgent;
struct {
HAGENT hAgent;
DWORD dwAgentState;
DWORD dwNextAgentState;
} SetAgentStateEx;
struct {
HAGENT hAgent;
DWORD dwMeasurementPeriod;
} SetAgentMeasurementPeriod;
struct {
HAGENT hAgent;
LINEAGENTINFO AgentInfo;
} GetAgentInfo;
struct {
HAGENTSESSION hAgentSession;
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
HAGENT hAgent;
GUID GroupID;
DWORD dwWorkingAddressID;
} CreateAgentSession;
struct {
HAGENT hAgent;
LINEAGENTSESSIONLIST SessionList;
} GetAgentSessionList;
struct {
HAGENTSESSION hAgentSession;
LINEAGENTSESSIONINFO SessionInfo;
} GetAgentSessionInfo;
struct {
HAGENTSESSION hAgentSession;
DWORD dwAgentSessionState;
DWORD dwNextAgentSessionState;
} SetAgentSessionState;
struct {
GUID GroupID;
LINEQUEUELIST QueueList;
} GetQueueList;
struct {
DWORD dwQueueID;
DWORD dwMeasurementPeriod;
} SetQueueMeasurementPeriod;
struct {
DWORD dwQueueID;
LINEQUEUEINFO QueueInfo;
} GetQueueInfo;
struct {
LINEAGENTGROUPLIST GroupList;
} GetGroupList;
};
} LINEPROXYREQUEST, *LPLINEPROXYREQUEST;
メンバー
dwSize
LINEPROXYREQUEST 構造体を格納するために TAPI によって割り当てられた合計バイト数。 LINEPROXYREQUEST (LINEAGENTCAPS など) に含まれる構造体の dwTotalSize メンバーは、その特定の構造体に割り当てられたバイト数のみを反映します。 Params パラメーター ブロックの合計サイズ (バイト単位)。
dwClientMachineNameSize
クライアント コンピューター名文字列のサイズ ( null 終端文字を含むバイト単位)。
dwClientMachineNameOffset
構造体の先頭から、この要求を行ったクライアント コンピューターを識別する null で終わる文字列へのオフセット。 文字列のサイズは dwClientMachineNameSize によって指定されます。
dwClientUserNameSize
クライアント ユーザー名文字列のサイズ ( null 終端文字を含むバイト単位)。
dwClientUserNameOffset
構造体の先頭から、クライアント コンピューターでアプリケーションが実行されているアカウントのユーザーを識別する null で終わる文字列へのオフセット。 文字列のサイズは dwClientUserNameSize によって指定されます。
dwClientAppAPIVersion
要求を行ったアプリケーションでサポートされている最高の API バージョン。 プロキシ ハンドラーは、アプリケーションに返されるデータの内容を、このバージョンまたは以前のバージョンの TAPI で定義されたメンバーと値に制限する必要があります。
dwRequestType
LINEPROXYREQUEST_定数の 1 つ。 構造体内の残りのデータを定義する関数の種類と共用体コンポーネントを識別します。
SetAgentGroup
dwRequestType がLINEPROXYREQUEST_SETAGENTされるときに使用される共用体コンポーネント。
SetAgentGroup.dwAddressID
エージェントを設定するアドレスの識別子。
SetAgentGroup.GroupList
LINEAGENTGROUPLIST 型の構造。 この構造体内のオフセットは、LINEPROXYREQUEST 構造体の先頭ではなく、SetAgentGroup.GroupList の先頭を基準とします。
SetAgentState
dwRequestType がLINEPROXYREQUEST_SETAGENTSTATEされるときに使用される共用体コンポーネント。
SetAgentState.dwAddressID
エージェントの状態を設定するアドレスの識別子。
SetAgentState.dwAgentState
新しいエージェントの状態、またはエージェントの状態を変更しない場合は 0。
SetAgentState.dwNextAgentState
指定したエージェント状態に関連付けられている既定の次の状態を使用する新しい次のエージェント状態、または 0。
SetAgentActivity
dwRequestType がLINEPROXYREQUEST_SETAGENTACTIVITYされるときに使用される共用体コンポーネント。
SetAgentActivity.dwAddressID
エージェント アクティビティを設定するアドレスの識別子。
SetAgentActivity.dwActivityID
選択されているアクティビティの識別子。
GetAgentCaps
dwRequestType がLINEPROXYREQUEST_GETAGENTCAPSされるときに使用される共用体コンポーネント。
GetAgentCaps.dwAddressID
エージェント機能を取得するアドレスの識別子。
GetAgentCaps.AgentCaps
LINEAGENTCAPS 型の構造。 この構造体内のオフセットは、LINEPROXYREQUEST 構造体の先頭ではなく、GetAgentCaps.AgentCaps の先頭を基準とします。 dwTotalSize メンバーは TAPI によって設定され、残りのバイトは 0 に設定されます。 プロキシ ハンドラーは、lineProxyResponse を呼び出す前に、必要に応じて dwNeededSize、dwUsedSize、および残りのメンバーを入力する必要があります。
GetAgentStatus
dwRequestType がLINEPROXYREQUEST_SETAGENTGROUPされるときに使用される共用体コンポーネント。
GetAgentStatus.dwAddressID
エージェントの状態を取得するアドレスの識別子。
GetAgentStatus.AgentStatus
LINEAGENTSTATUS 型の構造。 この構造体内のオフセットは、LINEPROXYREQUEST 構造体の先頭ではなく、GetAgentStatus.AgentStatus の先頭を基準とします。 dwTotalSize メンバーは TAPI によって設定され、残りのバイトは 0 に設定されます。 プロキシ ハンドラーは、lineProxyResponse を呼び出す前に、必要に応じて dwNeededSize、dwUsedSize、および残りのメンバーを入力する必要があります。
AgentSpecific
dwRequestType がLINEPROXYREQUEST_AGENTSPECIFICされるときに使用される共用体コンポーネント。
AgentSpecific.dwAddressID
エージェントの状態を取得するアドレスの識別子。
AgentSpecific.dwAgentExtensionIDIndex
呼び出されるハンドラー拡張機能のインデックス。 LINEAGENTCAPS で返される拡張識別子の配列内の識別子の位置。
AgentSpecific.dwSize
Params パラメーター ブロックの合計サイズ (バイト単位)。
AgentSpecific.Params[1]
アプリケーションからハンドラーに渡される内容を含むメモリブロック。 ハンドラーがアプリケーションにデータを返す場合は、 lineProxyResponse を呼び出す前に、このパラメーター ブロックに書き込む必要があります。
GetAgentActivityList
dwRequestType がLINEPROXYREQUEST_GETAGENTACTIVITYLISTされるときに使用される共用体コンポーネント。
GetAgentActivityList.dwAddressID
エージェント アクティビティ リストを取得するアドレスの識別子。
GetAgentActivityList.ActivityList
LINEAGENTACTIVITYLIST 型の構造。 この構造体内のオフセットは、LINEPROXYREQUEST 構造体の先頭ではなく、GetAgentActivityList.ActivityList の先頭を基準とします。 dwTotalSize メンバーは TAPI によって設定され、残りのバイトは 0 に設定されます。 プロキシ ハンドラーは、lineProxyResponse を呼び出す前に、必要に応じて dwNeededSize、dwUsedSize、および残りのメンバーを入力する必要があります。
GetAgentGroupList
dwRequestType がLINEPROXYREQUEST_GETAGENTGROUPLISTされるときに使用される共用体コンポーネント。
GetAgentGroupList.dwAddressID
エージェント グループの一覧を取得するアドレスの識別子。
GetAgentGroupList.GroupList
LINEAGENTGROUPLIST 型の構造。 この構造体内のオフセットは、LINEPROXYREQUEST 構造体の先頭ではなく、GetAgentGroupList.GroupList の先頭を基準とします。 dwTotalSize メンバーは TAPI によって設定され、残りのバイトは 0 に設定されます。 プロキシ ハンドラーは、lineProxyResponse を呼び出す前に、必要に応じて dwNeededSize、dwUsedSize、および残りのメンバーを入力する必要があります。
CreateAgent
dwRequestType がLINEPROXYREQUEST_CREATEAGENTされるときに使用される共用体コンポーネント。
CreateAgent.hAgent
エージェントの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
CreateAgent.dwAgentIDSize
エージェント ID 文字列のサイズ (バイト単位)。
CreateAgent.dwAgentIDOffset
構造体の先頭から、エージェントの ID を指定する null で終わる文字列へのオフセット。 文字列のサイズは dwAgentIDSize で指定します。
CreateAgent.dwAgentPINSize
NULL 終端記号を含む PIN 文字列のサイズ (バイト単位)。
CreateAgent.dwAgentPINOffset
構造体の先頭から、エージェントの PIN またはパスワードを指定する null で終わる文字列へのオフセット。 文字列のサイズは dwAgentPINSize で指定します。
SetAgentStateEx
dwRequestType がLINEPROXYREQUEST_SETAGENTSTATEEXされるときに使用される共用体コンポーネント。
SetAgentStateEx.hAgent
エージェントの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
SetAgentStateEx.dwAgentState
LINEAGENTSTATEEX_定数の 1 つ。
SetAgentStateEx.dwNextAgentState
LINEAGENTSTATEEX_定数の 1 つ。
SetAgentMeasurementPeriod
dwRequestType がLINEPROXYREQUEST_SETAGENTMEASUREMENTPERIODされるときに使用される共用体コンポーネント。
SetAgentMeasurementPeriod.hAgent
エージェントの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
SetAgentMeasurementPeriod.dwMeasurementPeriod
スイッチまたは実装が情報を格納および計算する期間 (秒単位)。 たとえば、 dwNumberOfACDCalls は 、エージェントが処理した呼び出しの数を保持します。 dwMeasurementPeriod は 、この値が過去 1 時間、日、または月で処理された呼び出しを参照しているかどうかを示します。
GetAgentInfo
dwRequestType がLINEPROXYREQUEST_GETAGENTINFOされるときに使用される共用体コンポーネント。
GetAgentInfo.hAgent
エージェントの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
GetAgentInfo.AgentInfo
LINEAGENTINFO 型の構造。
CreateAgentSession
dwRequestType がLINEPROXYREQUEST_CREATEAGENTSESSIONされるときに使用される共用体コンポーネント。
CreateAgentSession.hAgentSession
エージェント セッションの一意識別子。
CreateAgentSession.dwAgentPINSize
null 終端記号を含むエージェント PIN 文字列のサイズ (バイト単位)。
CreateAgentSession.dwAgentPINOffset
構造体の先頭から、エージェントの PIN またはパスワードを指定する null で終わる文字列へのオフセット。 この文字列のサイズは dwAgentPINSize によって指定されます。
CreateAgentSession.hAgent
エージェントの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
CreateAgentSession.GroupID
ACD グループの汎用一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
CreateAgentSession.dwWorkingAddressID
エージェントがこのセッションの呼び出しを受信するアドレスの識別子。
GetAgentSessionList
dwRequestType がLINEPROXYREQUEST_GETAGENTSESSIONLISTされるときに使用される共用体コンポーネント。
GetAgentSessionList.hAgent
エージェントの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
GetAgentSessionList.SessionList
GetAgentSessionInfo
dwRequestType がLINEPROXYREQUEST_GETAGENTSESSIONINFOされるときに使用される共用体コンポーネント。
GetAgentSessionInfo.hAgentSession
エージェント セッションの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
GetAgentSessionInfo.SessionInfo
SetAgentSessionState
dwRequestType がLINEPROXYREQUEST_SETAGENTSESSIONSTATEされるときに使用される共用体コンポーネント。
SetAgentSessionState.hAgentSession
エージェント セッションの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
SetAgentSessionState.dwAgentSessionState
LINEAGENTSESSIONSTATE_定数の 1 つ。
SetAgentSessionState.dwNextAgentSessionState
LINEAGENTSESSIONSTATE_定数の 1 つ。
GetQueueList
dwRequestType がLINEPROXYREQUEST_GETQUEUELISTされるときに使用される共用体コンポーネント。
GetQueueList.GroupID
ACD グループの汎用一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
GetQueueList.QueueList
LINEQUEUELIST 型の構造。
SetQueueMeasurementPeriod
dwRequestType がLINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIODされるときに使用される共用体コンポーネント。
SetQueueMeasurementPeriod.dwQueueID
キューの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
SetQueueMeasurementPeriod.dwMeasurementPeriod
スイッチまたは実装が情報を格納および計算する期間 (秒単位)。
GetQueueInfo
dwRequestType がLINEPROXYREQUEST_GETQUEUEINFOされるときに使用される共用体コンポーネント。
GetQueueInfo.dwQueueID
キューの一意識別子。 この識別子の一意性を生成して維持するのは、エージェント ハンドラーの役割です。
GetQueueInfo.QueueInfo
LINEQUEUEINFO 型の構造。
GetGroupList
dwRequestType がLINEPROXYREQUEST_GETGROUPLISTされるときに使用される共用体コンポーネント。
GetGroupList.GroupList
LINEAGENTGROUPLIST 型の構造。
注釈
アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティング システムのアップグレード間で一定のままです。
要件
| 要件 | 値 |
|---|---|
| Header | tapi.h |