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 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 |
|---|---|
|
Methode war erfolgreich. |
|
Der Agent wurde nicht von CreateAgentWithID erstellt. |
|
Der Vorgang ist fehlgeschlagen, weil für die TAPI 3-DLL ein Timeout aufgetreten ist. Das Timeoutintervall beträgt zwei Minuten. |
|
pPIN ist NULL. |
|
Der Parameter pPIN oder ppAgentSession ist kein gültiger Zeiger. |
|
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 |