ITAddress::Forward-Methode (tapi3if.h)

Artikel
08/26/2023

Die Forward-Methode leitet Aufrufe, die für die Adresse bestimmt sind, gemäß den Weiterleitungsanweisungen in ITForwardInformation weiter. Wenn pForwardInfo auf NULL festgelegt ist, wird die Weiterleitung abgebrochen.

Syntax

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

Parameter

[in] pForwardInfo

Zeiger auf die ITForwardInformation-Schnittstelle , oder legen Sie auf NULL fest, um die Weiterleitung abzubrechen.

[in] pCall

Zeiger auf die ITBasicCallControl-Schnittstelle für den Beratungsanruf, falls dies für die Telefonieumgebung erforderlich ist. Kann NULL sein, wenn dies nicht erforderlich ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_INVALIDARG	Die Adresse unterstützt keine Weiterleitung, oder pCall verweist nicht auf einen gültigen Anruf.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_POINTER	Der pForwardInfo - oder pCall-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.
LINEERR_	Fehlercodes, die von dieser TAPI 2.1-Funktion zurückgegeben werden, finden Sie unter LineForward .

Hinweise

Die Informationen in pForwardInfo überschreiben alle vorherigen Weiterleitungsanweisungen.

Wenn ITAddress::p ut_DoNotDisturb aufgerufen wird und fDoNotDisturb auf VARIANT_FALSE festgelegt ist, wird die gesamte Weiterleitung abgebrochen.

Eine Anwendung kann ermitteln, ob ein Nicht-NULL-Konsultationsaufruf erforderlich ist, indem itAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) aufgerufen und überprüft wird, ob das Flag LINEADDRCAPFLAGS_FWDCONSULT, ein Mitglied von LINEADDRCAPFLAGS_ Constants, in plCapability festgelegt wurde. Wenn er festgelegt ist, ist für den pCall-Parameter der Forward-Methode ein Wert ungleich NULL erforderlich.

Die Forward-Methode ist teilweise ein COM-Wrapper für die TAPI 2.1 LineForward-Funktion .