ITAgent::CreateSession-Methode (tapi3.h)

Artikel
03/02/2024

Die CreateSession-Methode erstellt eine neue Agentsitzung für die ACD-Eingabegruppe und -Adresse.

Syntax

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

Parameter

[in] pACDGroup

Zeiger auf die ITACDGroup-Schnittstelle .

[in] pAddress

Zeiger auf das ITAddress-Objekt , das für den Empfang von ACD-Aufrufen verfügbar ist.

[out] ppAgentSession

Zeiger auf die ITAgentSession-Schnittstelle für das erstellte Objekt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_POINTER	Der ppAgentSession-Parameter ist kein gültiger Zeiger.
E_UNEXPECTED	Fehler beim Öffnen einer Zeile für die Zieladresse.
E_INVALIDARG	Das Argument pACDGroup oder pAddress ist ungültig.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
TAPI_E_TIMEOUT	Der Vorgang ist fehlgeschlagen, da die TAPI 3-DLL ein Timeout aufweist. Das Timeoutintervall beträgt zwei Minuten.

Hinweise

TAPI ruft die AddRef-Methode für die von ITAgent::CreateSession zurückgegebene ITAgentSession-Schnittstelle auf. Die Anwendung muss Release auf der ITAgentSession-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Einige Telefonumgebungen erfordern eine persönliche Identifikationsnummer, um eine Sitzung zu öffnen. Weitere Informationen finden Sie unter CreateSessionWithPIN.