ITAddress::CreateForwardInfoObject-Methode (tapi3if.h)
Die CreateForwardInfoObject-Methode erstellt das Weiterleitungsinformationsobjekt und gibt einen ITForwardInformation-Schnittstellenzeiger zurück. Diese Schnittstelle macht Methoden verfügbar, mit denen eine Anwendung Aspekte der Weiterleitung eines Aufrufs steuern kann, z. B. ob interne Aufrufe anders behandelt werden als externe Aufrufe.
Syntax
HRESULT CreateForwardInfoObject(
[out] ITForwardInformation **ppForwardInfo
);
Parameter
[out] ppForwardInfo
Zeiger auf die ITForwardInformation-Schnittstelle .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Der ppForwardInfo-Parameter ist kein gültiger Zeiger. |
Hinweise
Die Anwendung muss Informationen zu einem neu erstellten ITForwardInformation-Objekt festlegen, bevor das Objekt verwendet werden kann.
TAPI ruft die AddRef-Methode auf der ITForwardInformation-Schnittstelle auf, die von ITAddress::CreateForwardInfoObject zurückgegeben wird. Die Anwendung muss Release auf der ITForwardInformation-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |