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

Anforderungen

Siehe auch

LINEPROXYREQUEST-

LINE_PROXYREQUEST