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
S_OK
Methode war erfolgreich.
E_OUTOFMEMORY
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
E_POINTER
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

Weitere Informationen

Adressobjekt

Vorwärts

ITAddress

ITForwardInformation

get_CurrentForwardInfo