LINEPROXYREQUEST 結構包含發出 Proxy 要求之應用程式的參數值。 多個 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
TAPI 配置的位元組總數，以包含 LINEPROXYREQUEST 結構。 dwTotalSize 包含在 LINEPROXYREQUEST 內的任何 結構成員（例如，LINEAGENTCAPS）只會反映配置給該特定結構的位元組數目。 參數區塊 Para ms 的大小總計，以位元組為單位。
dwClientMachineNameSize
用戶端電腦名稱字串的大小，以位元組為單位，包括 null-terminating 字元。
dwClientMachineNameOffset
從結構的開頭位移至 null終止字元串，以識別發出此要求的用戶端計算機。 字串的大小是由 dwClientMachineNameSize指定。
dwClientUserNameSize
用戶端使用者名稱字串的大小，以位元組為單位，包括 null-terminating 字元。
dwClientUserNameOffset
從結構的開頭位移至 null終止字元串，識別應用程式在用戶端電腦上執行帳戶的使用者。 字串的大小是由 dwClientUserNameSize指定。
dwClientAppAPIVersion
提出要求的應用程式所支援的最高 API 版本。 Proxy 處理程式應該將傳回給應用程式的任何數據內容限制為此或舊版 TAPI 中定義的成員和值。
dwRequestType
其中一個 LINEPROXYREQUEST_ 常數。 識別函式的類型，以及定義 結構中剩餘數據的等位元件。
SetAgentGroup
dwRequestType 時使用的等位元件LINEPROXYREQUEST_SETAGENT。
SetAgentGroup.dwAddressID
要設定代理程式的位址識別碼。
SetAgentGroup.GroupList
LINEAGENTGROUPLIST 類型的結構 。 此結構中的位移相對於 setAgentGroup.GroupList 開頭，而不是 LINEPROXYREQUEST 結構的開頭。
SetAgentState
dwRequestType LINEPROXYREQUEST_SETAGENTSTATE 時使用的等位元件。
SetAgentState.dwAddressID
要設定代理程式狀態之位址的標識碼。
SetAgentState.dwAgentState
新的代理程序狀態，或零讓代理程序狀態保持不變。
SetAgentState.dwNextAgentState
新的下一個代理程序狀態，或零使用與指定代理程序狀態相關聯的預設下一個狀態。
SetAgentActivity
dwRequestType 時使用的等位元件LINEPROXYREQUEST_SETAGENTACTIVITY。
SetAgentActivity.dwAddressID
要設定代理程式活動的位址識別碼。
SetAgentActivity.dwActivityID
所選取活動的識別碼。
GetAgentCaps
dwRequestType LINEPROXYREQUEST_GETAGENTCAPS 時使用的等位元件。
GetAgentCaps.dwAddressID
要擷取代理程式功能的位址標識碼。
GetAgentCaps.AgentCaps
LINEAGENTCAPS 類型 結構。 此結構中的位移相對於 getAgentCaps.AgentCaps 的 開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI設定，而其餘的位元組則設定為零。 Proxy 處理程式必須填入 dwNeededSize、dwUsedSize，以及適當的其餘成員，才能呼叫 lineProxyResponse。
GetAgentStatus
dwRequestType LINEPROXYREQUEST_SETAGENTGROUP 時使用的等位元件。
GetAgentStatus.dwAddressID
要擷取代理程序狀態之地址的標識碼。
GetAgentStatus.AgentStatus
LINEAGENTSTATUS 類型的結構 。 此結構中的位移相對於 getAgentStatus.AgentStatus 的開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI設定，而其餘的位元組則設定為零。 Proxy 處理程式必須填入 dwNeededSize、dwUsedSize，以及適當的其餘成員，才能呼叫 lineProxyResponse。
AgentSpecific
dwRequestType LINEPROXYREQUEST_AGENTSPECIFIC 時使用的等位元件。
AgentSpecific.dwAddressID
要擷取代理程序狀態之地址的標識碼。
AgentSpecific.dwAgentExtensionIDIndex
正在叫用之處理程式延伸模組的索引;在 LINEAGENTCAPS 中傳回之擴充標識子陣列中，標識碼的位置。
AgentSpecific.dwSize
參數區塊 Para ms 的大小總計，以位元組為單位。
AgentSpecific.Params[1]
記憶體區塊，其中包含從應用程式傳遞至處理程序的內容。 如果處理程式是要將資料傳回至應用程式，則必須先將它寫入此參數區塊，才能呼叫 lineProxyResponse。
GetAgentActivityList
dwRequestType LINEPROXYREQUEST_GETAGENTACTIVITYLIST 時使用的等位元件。
GetAgentActivityList.dwAddressID
要擷取代理程式活動清單之地址的標識碼。
GetAgentActivityList.ActivityList
LINEAGENTACTIVITYLIST 類型的結構 。 此結構中的位移相對於 getAgentActivityList.ActivityList 的開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI設定，而其餘的位元組則設定為零。 Proxy 處理程式必須填入 dwNeededSize、dwUsedSize，以及適當的其餘成員，才能呼叫 lineProxyResponse。
GetAgentGroupList
dwRequestType LINEPROXYREQUEST_GETAGENTGROUPLIST 時使用的等位元件。
GetAgentGroupList.dwAddressID
要擷取代理程式群組清單之位址的標識碼。
GetAgentGroupList.GroupList
LINEAGENTGROUPLIST 類型的結構 。 此結構內的位移相對於 getAgentGroupList.GroupList 開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI設定，而其餘的位元組則設定為零。 Proxy 處理程式必須填入 dwNeededSize、dwUsedSize，以及適當的其餘成員，才能呼叫 lineProxyResponse。
CreateAgent
dwRequestType LINEPROXYREQUEST_CREATEAGENT 時使用的等位元件。
CreateAgent.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
CreateAgent.dwAgentIDSize
代理程式識別符字串的大小，以位元組為單位。
CreateAgent.dwAgentIDOffset
從結構的開頭到指定代理程式標識碼的 null -terminated 字串位移。 字串的大小是由 dwAgentIDSize所指定。
CreateAgent.dwAgentPINSize
PIN 字串的大小，包括 null 終止符，以位元組為單位。
CreateAgent.dwAgentPINOffset
從結構的開頭到指定代理程式 PIN 或密碼的 null null終止字串的位移。 字串的大小是由 dwAgentPINSize 所指定。
SetAgentStateEx
dwRequestType LINEPROXYREQUEST_SETAGENTSTATEEX 時使用的等位元件。
SetAgentStateEx.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
SetAgentStateEx.dwAgentState
其中一個 LINEAGENTSTATEEX_ 常數。
SetAgentStateEx.dwNextAgentState
其中一個 LINEAGENTSTATEEX_ 常數。
SetAgentMeasurementPeriod
dwRequestType 時使用的等位元件LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD。
SetAgentMeasurementPeriod.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
SetAgentMeasurementPeriod.dwMeasurementPeriod
參數或實作儲存和計算信息的期間，以秒為單位。 例如，dwNumberOfACDCalls 保留代理程式處理的呼叫數目;dwMeasurementPeriod 指出此值是否參考過去一小時、日或月中處理的呼叫。
GetAgentInfo
dwRequestType LINEPROXYREQUEST_GETAGENTINFO 時使用的等位元件。
GetAgentInfo.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
GetAgentInfo.AgentInfo
LINEAGENTINFO 類型 結構。
CreateAgentSession
dwRequestType LINEPROXYREQUEST_CREATEAGENTSESSION 時使用的等位元件。
CreateAgentSession.hAgentSession
代理程式會話的唯一標識符。
CreateAgentSession.dwAgentPINSize
代理程式 PIN 字串的大小，包括 null 終止符，以位元組為單位。
CreateAgentSession.dwAgentPINOffset
從結構的開頭到指定代理程式 PIN 或密碼的 null 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_ 常數。
SetAgentSessionState.dwNextAgentSessionState
其中一個 LINEAGENTSESSIONSTATE_ 常數。
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
GetGroupList
dwRequestType 時使用的等位元件LINEPROXYREQUEST_GETGROUPLIST。
GetGroupList.GroupList
言論
地址標識碼與位址永久相關聯;標識碼在作系統升級之間維持不變。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | tapi.h |