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