Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Methode war erfolgreich. |
|
Der Agent wurde nicht von CreateAgentWithID erstellt. |
|
Der Vorgang ist fehlgeschlagen, da die TAPI 3-DLL ein Timeout aufweist. Das Timeoutintervall beträgt zwei Minuten. |
|
pPIN ist NULL. |
|
Der pPIN - oder ppAgentSession-Parameter ist kein gültiger Zeiger. |
|
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 |