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, wobei auf eine LINEPROXYREQUEST- Struktur des Typs LINEPROXYREQUEST_CREATEAGENTSESSION verwiesen wird.
Syntax
LONG lineCreateAgentSessionA(
HLINE hLine,
HAGENT hAgent,
LPCSTR lpszAgentPIN,
DWORD dwWorkingAddressID,
LPGUID lpGroupID,
LPHAGENTSESSION lphAgentSession
);
Parameter
hLine
Behandeln sie das Leitungsgerät.
hAgent
Bezeichner des Agents, für den die Sitzung erstellt werden soll.
lpszAgentPIN
Zeiger auf eine NULL--terminated Unicode-Zeichenfolge, die die Agent-PIN oder das Kennwort enthält. Wird beim Arbeiten mit älteren ACD-Systemen verwendet, die eine separate PIN für jede erstellte Sitzung (oder Gruppe angemeldet) benötigen. Bei einem ACD-System, das die Benutzeranmeldung des Betriebssystems für die Authentifizierung verwendet, wird lpszAgentPIN auf NULL-festgelegt.
dwWorkingAddressID
Bezeichner der Adresse, an der der Agent Anrufe für diese Sitzung empfängt.
lpGroupID
Zeigen Sie auf eine GUID, die die Gruppe identifiziert, für die die Sitzung erstellt wird.
lphAgentSession
Behandeln Sie die vom ACD-Proxy zurückgegebene Agentsitzung. Es liegt in der Verantwortung der Agent-Handlerproxyanwendung, diese Bezeichner zu generieren und zu verwalten.
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.
Bemerkungen
Anmerkung
Der header tapi.h 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- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |