IFaxOutboundRoutingRules::Add 方法 (faxcomex.h)

IFaxOutboundRoutingRules::Add 方法會將輸出路由規則 (新增至 IFaxOutboundRoutingRule 介面) IFaxOutboundRoutingRules 介面所定義的集合。

語法

HRESULT Add(
                long                    lCountryCode,
                long                    lAreaCode,
                VARIANT_BOOL            bUseDevice,
                BSTR                    bstrGroupName,
                long                    lDeviceId,
  [out, retval] IFaxOutboundRoutingRule **pFaxOutboundRoutingRule
);

參數

lCountryCode

類型: long

long 值,指定要與輸出路由規則相關聯的國家/地區代碼。 指定 frrcANY_CODE 將會新增適用於任何國家/地區代碼的規則。

lAreaCode

類型: long

指定 long 值,指出要與輸出路由規則相關聯的區域代碼。 指定 frrcANY_CODE 將會新增規則,以套用至指定國家/地區代碼內的任何區域代碼。

bUseDevice

類型: VARIANT_BOOL

指定布爾值,指出輸出路由規則是否指向單一傳真裝置,而不是指向裝置群組。

bstrGroupName

類型: BSTR

指定 Null 終止的字串,其中包含新路由規則所屬之輸出路由群組的名稱。 如果 bUseDevice 設定為 TRUE,這應該是空字串。

lDeviceId

類型: long

指定要與輸出路由規則建立關聯的裝置。 如果 bUseDevice 設定為 FALSE,則會忽略此參數。

[out, retval] pFaxOutboundRoutingRule

類型: IFaxOutboundRoutingRule**

接收 IFaxOutboundRoutingRule 介面的指標位址。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

這個方法也可以 (RPC) 傳回值傳回遠端過程調用。 如需詳細資訊,請參閱 RPC 傳回值

若要讀取或寫入此屬性,用戶必須具有 farMANAGE_CONFIG 訪問許可權。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 faxcomex.h
Dll Fxscomex.dll

另請參閱

IFaxOutboundRoutingRules

Visual Basic 範例