Freigeben über


ITAgent::CreateSession-Methode (tapi3.h)

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.

Anforderungen

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

Weitere Informationen

IEnumAgentSession

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession