ITAddress：：Forward 方法 (tapi3if.h)

發行項
08/26/2023

Forward 方法會根據 ITForwardInformation中包含的轉送指示，轉送目的地為位址的呼叫。如果 pForwardInfo 設定為 Null，則會取消轉送。

語法

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

參數

[in] pForwardInfo

ITForwardInformation介面的指標，或設定為Null以取消轉送。

[in] pCall

如果電話語音環境需要，則為諮詢通話的 ITBasicCallControl 介面指標。如果不需要，則可能為 Null 。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	方法成功。
E_INVALIDARG	位址不支援轉送，或 pCall 未指向有效的呼叫。
E_OUTOFMEMORY	記憶體不足，無法執行作業。
E_POINTER	pForwardInfo或pCall參數不是有效的指標。
TAPI_E_TIMEOUT	作業失敗，因為 TAPI 3 DLL 已逾時。逾時間隔為兩分鐘。
LINEERR_	如需從此 TAPI 2.1 函式傳回的錯誤碼，請參閱 LineForward 。

備註

pForwardInfo中的資訊會覆寫任何先前的轉送指示。

如果呼叫 ITAddress：:p ut_DoNotDisturb ， 並將 fDoNotDisturb 設定為 VARIANT_FALSE，則會取消所有轉送。

應用程式可以呼叫ITAddressCapabilities：：get_AddressCapability (AC_ADDRESSCAPFLAGS、plCapability) ，並檢查旗標LINEADDRCAPFLAGS_FWDCONSULT是否LINEADDRCAPFLAGS_常數的成員設定，以判斷是否需要非Null諮詢呼叫。如果已設定，則 Forward 方法的pCall參數需要非Null值。

Forward 方法是 TAPI 2.1 LineForward 函式的 COM 包裝函式。