lineCreateAgentSessionA-Funktion (tapi.h)
Die lineCreateAgentSession-Funktion erstellt ein neues AgentSession-Objekt. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll und auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_CREATEAGENTSESSION verweist.
Syntax
LONG lineCreateAgentSessionA(
HLINE hLine,
HAGENT hAgent,
LPCSTR lpszAgentPIN,
DWORD dwWorkingAddressID,
LPGUID lpGroupID,
LPHAGENTSESSION lphAgentSession
);
Parameter
hLine
Handle zum Leitungsgerät.
hAgent
Bezeichner des Agents, für den die Sitzung erstellt werden soll.
lpszAgentPIN
Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die die Agent-PIN oder das Kennwort enthält. Wird verwendet, wenn Sie mit älteren ACD-Systemen arbeiten, die eine separate PIN für jede erstellte (oder angemeldete Gruppe) benötigen. Bei einem ACD-System, das die Benutzeranmeldung des Betriebssystems für die Authentifizierung verwendet, ist lpszAgentPIN auf NULL festgelegt.
dwWorkingAddressID
Bezeichner der Adresse, unter der der Agent Aufrufe für diese Sitzung empfängt.
lpGroupID
Zeiger auf eine GUID, die die Gruppe identifiziert, für die die Sitzung erstellt wird.
lphAgentSession
Handle für die erstellte Agentsitzung, die vom ACD-Proxy zurückgegeben wird. Es liegt in der Verantwortung der Agenthandlerproxyanwendung, die Eindeutigkeit dieser Bezeichner zu generieren und beizubehalten.
Rückgabewert
Gibt einen Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt die Funktion einen der folgenden Fehlerwerte zurück:
LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Hinweise
Hinweis
Der tapi.h-Header definiert lineCreateAgentSession als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |