ITAddress::CreateForwardInfoObject-Methode (tapi3if.h)

Artikel
08/26/2023

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.