ITAgent::CreateSessionWithPIN-Methode (tapi3cc.h)

Artikel
03/02/2024

Die CreateSessionWithPIN-Methode erstellt eine neue Agentsitzung für die Eingabe-ACD-Gruppe und -Adresse mit persönlicher Identifikationsnummer (PIN).

Syntax

HRESULT CreateSessionWithPIN(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [in]  BSTR           pPIN,
  [out] ITAgentSession **ppAgentSession
);

Parameter

[in] pACDGroup

Zeiger auf die ITACDGroup-Schnittstelle .

[in] pAddress

Zeiger auf die ITAddress-Schnittstelle für ein Objekt, das zum Empfangen von ACD-Aufrufen verfügbar ist.

[in] pPIN

Zeiger auf eine BSTR-Darstellung der PIN des Agents.

[out] ppAgentSession

Zeiger auf die erstellte Sitzung.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
TAPI_E_CALLCENTER_NO_AGENT_ID	Der Agent wurde nicht von CreateAgentWithID erstellt.
TAPI_E_TIMEOUT	Der Vorgang ist fehlgeschlagen, da die TAPI 3-DLL ein Timeout aufweist. Das Timeoutintervall beträgt zwei Minuten.
E_INVALIDARG	pPIN ist NULL.
E_POINTER	Der pPIN - oder ppAgentSession-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für pPIN zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.

TAPI ruft die AddRef-Methode auf der VON ITAgent::CreateSessionWithPIN zurückgegebenen ITAgentSession-Schnittstelle auf. Die Anwendung muss Release auf der ITAgentSession-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi3cc.h (einschließlich Tapi3.h)
Bibliothek	Uuid.lib
DLL	Tapi3.dll

Weitere Informationen

ITAgent

ITAgent::CreateSession

ITAgentSession

Freigeben über