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, wobei auf eine LINEPROXYREQUEST- Struktur des Typs LINEPROXYREQUEST_CREATEAGENT verwiesen wird.
Syntax
LONG lineCreateAgentA(
HLINE hLine,
LPCSTR lpszAgentID,
LPCSTR lpszAgentPIN,
LPHAGENT lphAgent
);
Parameter
hLine
Behandeln sie das Leitungsgerät.
lpszAgentID
Zeiger auf eine NULL--terminated Unicode-Zeichenfolge, die den Agentbezeichner enthält. Wird beim Arbeiten mit älteren ACD-Systemen verwendet. Bei einem ACD-System, das die Benutzeranmeldung des Betriebssystems für die Authentifizierung verwendet, wird lpszAgentID- auf NULL-festgelegt.
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. Bei einem ACD-System, das die Benutzeranmeldung des Betriebssystems für die Authentifizierung verwendet, wird lpszAgentPIN auf NULL-festgelegt.
lphAgent
Behandeln Sie den erstellten Agent, der vom ACD-Proxy zurückgegeben wird. Es liegt in der Verantwortung der Agent-Handlerproxyanwendung, um eindeutigen Bezeichner 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.
Bemerkungen
Anmerkung
Der header tapi.h 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- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |