ITAgentHandler::CreateAgentWithID-Methode (tapi3.h)
Die CreateAgentWithID-Methode erstellt ein Agent-Objekt basierend auf einem Agentbezeichner. Dieser Bezeichner ist eine Zeichenfolge, die den Agent in einem älteren ACD-System identifiziert. Wenn das System auch eine PIN oder ein Kennwort für die Anmeldung bei Gruppen erfordert, verwenden Sie diese Methode, um die PIN oder das Kennwort festzulegen.
Syntax
HRESULT CreateAgentWithID(
[in] BSTR pID,
[in] BSTR pPIN,
[out] ITAgent **ppAgent
);
Parameter
[in] pID
Zeiger auf BSTR , der den Agentbezeichner enthält.
[in] pPIN
Zeiger auf BSTR , der die Agent-PIN enthält.
[out] ppAgent
Zeiger auf die ITAgent-Schnittstelle .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der pPIN-Parameter ist NULL. |
|
Der ppAgent-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Der Vorgang ist fehlgeschlagen, weil für die TAPI 3-DLL ein Timeout aufgetreten ist. Das Timeoutintervall beträgt zwei Minuten. |
Hinweise
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für die pID - und pPIN-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variablen nicht mehr benötigt werden.
TAPI ruft die AddRef-Methode auf der ITAgent-Schnittstelle auf, die von ITAgentHandler::CreateAgentWithID zurückgegeben wird. Die Anwendung muss Release auf der ITAgent-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |