lineCreateAgentA-Funktion (tapi.h)
Die lineCreateAgent-Funktion erstellt ein neues Agent-Objekt. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll und auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_CREATEAGENT verweist.
Syntax
LONG lineCreateAgentA(
HLINE hLine,
LPCSTR lpszAgentID,
LPCSTR lpszAgentPIN,
LPHAGENT lphAgent
);
Parameter
hLine
Handle zum Leitungsgerät.
lpszAgentID
Zeiger auf eine Unicode-Zeichenfolge, die null beendet wurde, die den Agentbezeichner enthält. Wird bei der Arbeit mit älteren ACD-Systemen verwendet. Bei einem ACD-System, das die Benutzeranmeldung des Betriebssystems für die Authentifizierung verwendet, ist lpszAgentID auf NULL festgelegt.
lpszAgentPIN
Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die die Agent-PIN oder das Kennwort enthält. Wird bei der Arbeit mit älteren ACD-Systemen verwendet. Bei einem ACD-System, das die Benutzeranmeldung des Betriebssystems für die Authentifizierung verwendet, ist lpszAgentPIN auf NULL festgelegt.
lphAgent
Handle für den erstellten Agent, der vom ACD-Proxy zurückgegeben wird. Es liegt in der Verantwortung der Agenthandlerproxyanwendung, die Eindeutigkeit dieses Bezeichners zu generieren und aufrechtzuerhalten.
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 lineCreateAgent 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 |