ITAgent::CreateSessionWithPIN-Methode (tapi3cc.h)
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 |