ITAgent::CreateSessionWithPIN-Methode (tapi3.h)

Artikel
08/26/2023

Die CreateSessionWithPIN-Methode erstellt eine neue Agentsitzung für die ACD-Eingabegruppe 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 das Objekt, das für den Empfang 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, weil für die TAPI 3-DLL ein Timeout aufgetreten ist. Das Timeoutintervall beträgt zwei Minuten.
E_INVALIDARG	pPIN ist NULL.
E_POINTER	Der Parameter pPIN oder ppAgentSession ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

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

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

Anforderungen


Zielplattform	Windows
Kopfzeile	tapi3.h (Tapi3.h einschließen)
Bibliothek	Uuid.lib
DLL	Tapi3.dll

Weitere Informationen

ITAgent

ITAgent::CreateSession

ITAgentSession

Freigeben über