ITAgentHandler::CreateAgent-Methode (tapi3.h)
Die CreateAgent-Methode erstellt ein Agent-Objekt.
Syntax
HRESULT CreateAgent(
[out] ITAgent **ppAgent
);
Parameter
[out] ppAgent
Zeiger auf die ITAgent-Schnittstelle .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Der ppAgent-Parameter ist kein gültiger Zeiger. |
|
Der Vorgang ist fehlgeschlagen, weil für die TAPI 3-DLL ein Timeout aufgetreten ist. Das Timeoutintervall beträgt zwei Minuten. |
Hinweise
TAPI ruft die AddRef-Methode auf der ITAgent-Schnittstelle auf, die von ITAgentHandler::CreateAgent zurückgegeben wird. Die Anwendung muss Release auf der ITAgent-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |