tapi.h (LINEPROXYREQUEST 結構)
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 結構的位元組總數。 例如，LINEAGENTCAPS) 內含之任何結構的 dwTotalSize 成員 (只會反映為該特定結構配置的位元元組數目。 Params 參數區塊的大小總計，以位元組為單位。
dwClientMachineNameSize
用戶端電腦名稱字串的大小，以位元組為單位，包括 Null 終止字元。
dwClientMachineNameOffset
從結構的開頭到 Null 終止字串的位移，識別發出此要求的用戶端電腦。 字串的大小是由 dwClientMachineNameSize 所指定。
dwClientUserNameSize
用戶端使用者名稱字串的大小，以位元組為單位，包括 Null 終止字元。
dwClientUserNameOffset
從結構的開頭位移為 以 Null 終止的字串，識別應用程式在用戶端電腦上執行其帳戶的使用者。 字串的大小是由 dwClientUserNameSize 所指定。
dwClientAppAPIVersion
提出要求的應用程式所支援的最高 API 版本。 Proxy 處理程式應該將傳回給應用程式的任何數據內容限制為此或舊版 TAPI 中定義的成員和值。
dwRequestType
其中一個 LINEPROXYREQUEST_常數。 識別函式的類型，以及定義 結構中剩餘數據的等位元件。
SetAgentGroup
LINEPROXYREQUEST_SETAGENT dwRequestType 時使用的等位元件。
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所設定，其餘位元組則設定為零。 在呼叫lineProxyResponse之前，Proxy處理程式必須填入 dwNeededSize、dwUsedSize 和其餘成員。
GetAgentStatus
dwRequestType LINEPROXYREQUEST_SETAGENTGROUP時使用的聯集元件。
GetAgentStatus.dwAddressID
要擷取代理程序狀態之地址的標識碼。
GetAgentStatus.AgentStatus
LINEAGENTSTATUS 類型的結構。 這個結構中的位移相對於 GetAgentStatus.AgentStatus 的 開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI所設定，其餘位元組則設定為零。 在呼叫lineProxyResponse之前，Proxy處理程式必須填入 dwNeededSize、dwUsedSize 和其餘成員。
AgentSpecific
LINEPROXYREQUEST_AGENTSPECIFIC dwRequestType 時使用的聯集元件。
AgentSpecific.dwAddressID
要擷取代理程序狀態之地址的標識碼。
AgentSpecific.dwAgentExtensionIDIndex
正在叫用之處理程式延伸模組的索引;標識元在 LINEAGENTCAPS 中傳回之擴充標識碼陣列中的位置。
AgentSpecific.dwSize
Params 參數區塊的大小總計，以位元組為單位。
AgentSpecific.Params[1]
記憶體區塊，其中包含從應用程式傳遞至處理程序的內容。 如果處理程式是要將數據傳回至應用程式，則必須在呼叫 lineProxyResponse之前，將其寫入此參數區塊。
GetAgentActivityList
dwRequestType LINEPROXYREQUEST_GETAGENTACTIVITYLIST時使用的聯集元件。
GetAgentActivityList.dwAddressID
要擷取代理程式活動清單之地址的標識碼。
GetAgentActivityList.ActivityList
LINEAGENTACTIVITYLIST 類型的結構。 這個結構內的位移相對於 GetAgentActivityList.ActivityList 的 開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI所設定，其餘位元組則設定為零。 在呼叫lineProxyResponse之前，Proxy處理程式必須填入 dwNeededSize、dwUsedSize 和其餘成員。
GetAgentGroupList
LINEPROXYREQUEST_GETAGENTGROUPLIST dwRequestType 時使用的聯集元件。
GetAgentGroupList.dwAddressID
要擷取代理程式群組清單之位址的標識碼。
GetAgentGroupList.GroupList
LINEAGENTGROUPLIST 類型的結構。 此結構中的位移相對於 GetAgentGroupList.GroupList 的 開頭，而不是 LINEPROXYREQUEST 結構的開頭。 dwTotalSize 成員是由TAPI所設定，其餘位元組則設定為零。 在呼叫lineProxyResponse之前，Proxy處理程式必須填入 dwNeededSize、dwUsedSize 和其餘成員。
CreateAgent
LINEPROXYREQUEST_CREATEAGENT dwRequestType 時使用的聯集元件。
CreateAgent.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
CreateAgent.dwAgentIDSize
代理程式識別符字串的大小，以位元組為單位。
CreateAgent.dwAgentIDOffset
從結構的開頭到指定代理程式標識碼之 Null 終止字串的位移。 字串的大小是由 dwAgentIDSize 所指定。
CreateAgent.dwAgentPINSize
PIN 字串的大小，包括 Null 終止符，以位元組為單位。
CreateAgent.dwAgentPINOffset
從結構的開頭到指定代理程式 PIN 或密碼的 Null 終止字串的位移。 字串的大小是由 dwAgentPINSize 所指定。
SetAgentStateEx
LINEPROXYREQUEST_SETAGENTSTATEEX dwRequestType 時使用的等位元件。
SetAgentStateEx.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
SetAgentStateEx.dwAgentState
其中一個 LINEAGENTSTATEEX_常數。
SetAgentStateEx.dwNextAgentState
其中一個 LINEAGENTSTATEEX_常數。
SetAgentMeasurementPeriod
dwRequestType LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD時使用的聯集元件。
SetAgentMeasurementPeriod.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
SetAgentMeasurementPeriod.dwMeasurementPeriod
參數或實作儲存和計算信息的期間，以秒為單位。 例如， dwNumberOfACDCalls 會保留代理程序處理的呼叫數目; dwMeasurementPeriod 指出此值是否參考過去一小時、日或月中處理的呼叫。
GetAgentInfo
LINEPROXYREQUEST_GETAGENTINFO dwRequestType 時使用的聯集元件。
GetAgentInfo.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
GetAgentInfo.AgentInfo
LINEAGENTINFO 類型的結構。
CreateAgentSession
LINEPROXYREQUEST_CREATEAGENTSESSION dwRequestType 時使用的等位元件。
CreateAgentSession.hAgentSession
代理程式會話的唯一標識符。
CreateAgentSession.dwAgentPINSize
代理程式 PIN 字串的大小，包括 Null 終止符，以位元組為單位。
CreateAgentSession.dwAgentPINOffset
從結構的開頭到指定代理程式 PIN 或密碼的 Null 終止字串的位移。 此字串的大小是由 dwAgentPINSize 所指定。
CreateAgentSession.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
CreateAgentSession.GroupID
ACD 群組的通用唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
CreateAgentSession.dwWorkingAddressID
代理程式將在此會話接收呼叫的位址標識碼。
GetAgentSessionList
dwRequestType LINEPROXYREQUEST_GETAGENTSESSIONLIST時使用的聯集元件。
GetAgentSessionList.hAgent
代理程式的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
GetAgentSessionList.SessionList
LINEAGENTSESSIONLIST 類型的結構。
GetAgentSessionInfo
LINEPROXYREQUEST_GETAGENTSESSIONINFO dwRequestType 時使用的等位元件。
GetAgentSessionInfo.hAgentSession
代理程式會話的唯一標識符。 代理程式處理程式負責產生和維護此標識碼的唯一性。
GetAgentSessionInfo.SessionInfo
LINEAGENTSESSIONINFO 類型的結構。
SetAgentSessionState
LINEPROXYREQUEST_SETAGENTSESSIONSTATE dwRequestType 時使用的聯集元件。
SetAgentSessionState.hAgentSession
代理程式會話的唯一標識符。 代理程式處理程式負責產生和維護此標識碼的唯一性。
SetAgentSessionState.dwAgentSessionState
其中一個 LINEAGENTSESSIONSTATE_常數。
SetAgentSessionState.dwNextAgentSessionState
其中一個 LINEAGENTSESSIONSTATE_常數。
GetQueueList
LINEPROXYREQUEST_GETQUEUELIST dwRequestType 時使用的等位元件。
GetQueueList.GroupID
ACD 群組的通用唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
GetQueueList.QueueList
LINEQUEUELIST 類型的結構。
SetQueueMeasurementPeriod
當 dwRequestType LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD時使用的聯集元件。
SetQueueMeasurementPeriod.dwQueueID
佇列的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
SetQueueMeasurementPeriod.dwMeasurementPeriod
參數或實作儲存和計算信息的期間，以秒為單位。
GetQueueInfo
dwRequestType LINEPROXYREQUEST_GETQUEUEINFO時使用的聯集元件。
GetQueueInfo.dwQueueID
佇列的唯一標識碼。 代理程式處理程式負責產生和維護此標識碼的唯一性。
GetQueueInfo.QueueInfo
LINEQUEUEINFO 類型的結構。
GetGroupList
LINEPROXYREQUEST_GETGROUPLIST dwRequestType 時所使用的等位元件。
GetGroupList.GroupList
LINEAGENTGROUPLIST 類型的結構。
備註
位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | tapi.h |