共用方式為

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

另請參閱

LINEAGENTACTIVITYLIST

LINEAGENTCAPS

LINEAGENTGROUPLIST

LINEAGENTSESSIONINFO

LINEAGENTSESSIONLIST

LINEAGENTSTATUS

LINEQUEUELIST

LINE_PROXYREQUEST

lineProxyResponse