LINEPROXYREQUEST-Struktur (tapi.h)
Die LINEPROXYREQUEST-Struktur enthält Parameterwerte der Anwendung, die die Proxyanforderung stellt. Mehrere TAPI-Callcenterfunktionen generieren eine LINE_PROXYREQUEST Meldung, die auf eine LINEPROXYREQUEST-Struktur verweist.
Syntax
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;
Member
dwSize
Die Gesamtanzahl der by TAPI zugeordneten Bytes, die die LINEPROXYREQUEST-Struktur enthalten. Der dwTotalSize-Member einer beliebigen Struktur, die in LINEPROXYREQUEST enthalten ist (z. B. LINEAGENTCAPS), gibt nur die Anzahl der Bytes an, die dieser spezifischen Struktur zugeordnet sind. Gesamtgröße des Params-Parameterblocks in Bytes.
dwClientMachineNameSize
Größe der Zeichenfolge des Clientcomputernamens in Byte, einschließlich des NULL-Endzeichens.
dwClientMachineNameOffset
Offset vom Anfang der -Struktur zu einer null-endenden Zeichenfolge, die den Clientcomputer identifiziert, der diese Anforderung gestellt hat. Die Größe der Zeichenfolge wird von dwClientMachineNameSize angegeben.
dwClientUserNameSize
Größe der Clientbenutzernamenszeichenfolge in Byte, einschließlich des NULL-Endzeichens.
dwClientUserNameOffset
Offset vom Anfang der -Struktur zu einer Zeichenfolge mit NULL-Beendigung, die den Benutzer identifiziert, unter dessen Konto die Anwendung auf dem Clientcomputer ausgeführt wird. Die Größe der Zeichenfolge wird von dwClientUserNameSize angegeben.
dwClientAppAPIVersion
Höchste API-Version, die von der Anwendung unterstützt wird, die die Anforderung gestellt hat. Der Proxyhandler sollte den Inhalt aller an die Anwendung zurückgegebenen Daten auf die Member und Werte beschränken, die in dieser oder früheren Versionen von TAPI definiert wurden.
dwRequestType
Eine der LINEPROXYREQUEST_ Konstanten. Gibt den Typ der Funktion und die Union-Komponente an, die die verbleibenden Daten in der -Struktur definiert.
SetAgentGroup
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENT ist.
SetAgentGroup.dwAddressID
Bezeichner der Adresse, für die der Agent festgelegt werden soll.
SetAgentGroup.GroupList
Struktur vom Typ LINEAGENTGROUPLIST. Offsets innerhalb dieser Struktur beziehen sich auf den Anfang von SetAgentGroup.GroupList und nicht auf den Anfang der LINEPROXYREQUEST-Struktur .
SetAgentState
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENTSTATE ist.
SetAgentState.dwAddressID
Bezeichner der Adresse, für die der Agentstatus festgelegt werden soll.
SetAgentState.dwAgentState
Neuer Agent-Status oder Null, um den Agentstatus unverändert zu lassen.
SetAgentState.dwNextAgentState
Neuer Status des nächsten Agents oder Null, um den dem angegebenen Agent-Status zugeordneten Standardzustand zu verwenden.
SetAgentActivity
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENTACTIVITY ist.
SetAgentActivity.dwAddressID
Bezeichner der Adresse, für die die Agent-Aktivität festgelegt werden soll.
SetAgentActivity.dwActivityID
Bezeichner für die ausgewählte Aktivität.
GetAgentCaps
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETAGENTCAPS ist.
GetAgentCaps.dwAddressID
Bezeichner der Adresse, für die die Agent-Funktionen abgerufen werden sollen.
GetAgentCaps.AgentCaps
Struktur vom Typ LINEAGENTCAPS. Offsets innerhalb dieser Struktur beziehen sich auf den Anfang von GetAgentCaps.AgentCaps und nicht auf den Anfang der LINEPROXYREQUEST-Struktur . Das dwTotalSize-Element wird von TAPI und die verbleibenden Bytes auf 0 (null) festgelegt. Der Proxyhandler muss dwNeededSize, dwUsedSize und die verbleibenden Member nach Bedarf ausfüllen, bevor lineProxyResponse aufgerufen wird.
GetAgentStatus
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENTGROUP ist.
GetAgentStatus.dwAddressID
Bezeichner der Adresse, für die der Agent status abgerufen werden soll.
GetAgentStatus.AgentStatus
Struktur vom Typ LINEAGENTSTATUS. Offsets innerhalb dieser Struktur beziehen sich auf den Anfang von GetAgentStatus.AgentStatus und nicht auf den Anfang der LINEPROXYREQUEST-Struktur . Das dwTotalSize-Element wird von TAPI und die verbleibenden Bytes auf 0 (null) festgelegt. Der Proxyhandler muss dwNeededSize, dwUsedSize und die verbleibenden Member nach Bedarf ausfüllen, bevor lineProxyResponse aufgerufen wird.
AgentSpecific
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_AGENTSPECIFIC ist.
AgentSpecific.dwAddressID
Bezeichner der Adresse, für die der Agent status abgerufen werden soll.
AgentSpecific.dwAgentExtensionIDIndex
Index der aufgerufenen Handlererweiterung; die Position des Bezeichners innerhalb des Arrays von Erweiterungsbezeichnern, die in LINEAGENTCAPS zurückgegeben werden.
AgentSpecific.dwSize
Gesamtgröße des Params-Parameterblocks in Bytes.
AgentSpecific.Params[1]
Speicherblock, der den Inhalt enthält, der von der Anwendung an den Handler übergeben wird. Wenn der Handler Daten an die Anwendung zurückgeben soll, muss er vor dem Aufrufen von lineProxyResponse in diesen Parameterblock geschrieben werden.
GetAgentActivityList
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETAGENTACTIVITYLIST ist.
GetAgentActivityList.dwAddressID
Bezeichner der Adresse, für die die Agent-Aktivitätsliste abgerufen werden soll.
GetAgentActivityList.ActivityList
Struktur vom Typ LINEAGENTACTIVITYLIST. Offsets innerhalb dieser Struktur sind relativ zum Anfang von GetAgentActivityList.ActivityList und nicht zum Anfang der LINEPROXYREQUEST-Struktur . Das dwTotalSize-Element wird von TAPI und die verbleibenden Bytes auf 0 (null) festgelegt. Der Proxyhandler muss dwNeededSize, dwUsedSize und die verbleibenden Member nach Bedarf ausfüllen, bevor lineProxyResponse aufgerufen wird.
GetAgentGroupList
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETAGENTGROUPLIST ist.
GetAgentGroupList.dwAddressID
Bezeichner der Adresse, für die die Agentgruppenliste abgerufen werden soll.
GetAgentGroupList.GroupList
Struktur vom Typ LINEAGENTGROUPLIST. Offsets innerhalb dieser Struktur sind relativ zum Anfang von GetAgentGroupList.GroupList und nicht zum Anfang der LINEPROXYREQUEST-Struktur . Das dwTotalSize-Element wird von TAPI und die verbleibenden Bytes auf 0 (null) festgelegt. Der Proxyhandler muss dwNeededSize, dwUsedSize und die verbleibenden Member nach Bedarf ausfüllen, bevor lineProxyResponse aufgerufen wird.
CreateAgent
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_CREATEAGENT ist.
CreateAgent.hAgent
Eindeutiger Bezeichner für einen Agent. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
CreateAgent.dwAgentIDSize
Größe der Agent-ID-Zeichenfolge in Bytes.
CreateAgent.dwAgentIDOffset
Offset vom Anfang der -Struktur zu einer NULL-endenden Zeichenfolge, die die ID des Agents angibt. Die Größe der Zeichenfolge wird von dwAgentIDSize angegeben.
CreateAgent.dwAgentPINSize
Größe der PIN-Zeichenfolge einschließlich des NULL-Abschlusszeichens in Bytes.
CreateAgent.dwAgentPINOffset
Offset vom Anfang der -Struktur zu einer Zeichenfolge mit NULL-Beendigung, die die PIN oder das Kennwort des Agents angibt. Die Größe der Zeichenfolge wird von dwAgentPINSize angegeben.
SetAgentStateEx
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENTSTATEEX ist.
SetAgentStateEx.hAgent
Eindeutiger Bezeichner für einen Agent. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
SetAgentStateEx.dwAgentState
Eine der LINEAGENTSTATEEX_ Konstanten.
SetAgentStateEx.dwNextAgentState
Eine der LINEAGENTSTATEEX_ Konstanten.
SetAgentMeasurementPeriod
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD ist.
SetAgentMeasurementPeriod.hAgent
Eindeutiger Bezeichner für einen Agent. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
SetAgentMeasurementPeriod.dwMeasurementPeriod
Zeitraum in Sekunden, für den der Switch oder die Implementierung Informationen speichert und berechnet. Beispielsweise enthält dwNumberOfACDCalls die Anzahl der Aufrufe, die der Agent verarbeitet. dwMeasurementPeriod gibt an, ob dieser Wert auf die Aufrufe der letzten Stunde, des letzten Tages oder Monats verweist.
GetAgentInfo
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETAGENTINFO ist.
GetAgentInfo.hAgent
Eindeutiger Bezeichner für einen Agent. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
GetAgentInfo.AgentInfo
Struktur vom Typ LINEAGENTINFO.
CreateAgentSession
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_CREATEAGENTSESSION ist.
CreateAgentSession.hAgentSession
Eindeutiger Bezeichner für eine Agentsitzung.
CreateAgentSession.dwAgentPINSize
Größe der Agent-PIN-Zeichenfolge einschließlich des NULL-Abschlusszeichens in Byte.
CreateAgentSession.dwAgentPINOffset
Offset vom Anfang der -Struktur zu einer Zeichenfolge mit NULL-Beendigung, die die PIN oder das Kennwort des Agents angibt. Die Größe dieser Zeichenfolge wird von dwAgentPINSize angegeben.
CreateAgentSession.hAgent
Eindeutiger Bezeichner für einen Agent. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
CreateAgentSession.GroupID
Universell eindeutiger Bezeichner für eine ACD-Gruppe. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
CreateAgentSession.dwWorkingAddressID
Bezeichner der Adresse, unter der der Agent Aufrufe für diese Sitzung empfängt.
GetAgentSessionList
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETAGENTSESSIONLIST ist.
GetAgentSessionList.hAgent
Eindeutiger Bezeichner für einen Agent. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
GetAgentSessionList.SessionList
Struktur vom Typ LINEAGENTSESSIONLIST.
GetAgentSessionInfo
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETAGENTSESSIONINFO ist.
GetAgentSessionInfo.hAgentSession
Eindeutiger Bezeichner für eine Agentsitzung. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
GetAgentSessionInfo.SessionInfo
Struktur vom Typ LINEAGENTSESSIONINFO.
SetAgentSessionState
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETAGENTSESSIONSTATE ist.
SetAgentSessionState.hAgentSession
Eindeutiger Bezeichner für eine Agentsitzung. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
SetAgentSessionState.dwAgentSessionState
Eine der LINEAGENTSESSIONSTATE_ Konstanten.
SetAgentSessionState.dwNextAgentSessionState
Eine der LINEAGENTSESSIONSTATE_ Konstanten.
GetQueueList
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETQUEUELIST ist.
GetQueueList.GroupID
Universell eindeutiger Bezeichner für eine ACD-Gruppe. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
GetQueueList.QueueList
Struktur vom Typ LINEQUEUELIST.
SetQueueMeasurementPeriod
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD ist.
SetQueueMeasurementPeriod.dwQueueID
Eindeutiger Bezeichner für eine Warteschlange. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
SetQueueMeasurementPeriod.dwMeasurementPeriod
Zeitraum in Sekunden, für den der Switch oder die Implementierung Informationen speichert und berechnet.
GetQueueInfo
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETQUEUEINFO ist.
GetQueueInfo.dwQueueID
Eindeutiger Bezeichner für eine Warteschlange. Es liegt in der Verantwortung des Agent-Handlers, die Eindeutigkeit dieses Bezeichners zu generieren und beizubehalten.
GetQueueInfo.QueueInfo
Struktur vom Typ LINEQUEUEINFO.
GetGroupList
Union-Komponente, die verwendet wird, wenn dwRequestType LINEPROXYREQUEST_GETGROUPLIST ist.
GetGroupList.GroupList
Struktur vom Typ LINEAGENTGROUPLIST.
Hinweise
Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | tapi.h |