Freigeben über


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
S_OK
Methode war erfolgreich.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_POINTER
Der ppAgent-Parameter ist kein gültiger Zeiger.
TAPI_E_TIMEOUT
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

Weitere Informationen

CreateAgentWithID

ITAgent

ITAgentHandler