共用方式為


FwpmIPsecTunnelAdd0 函式 (fwpmu.h)

FwpmIPsecTunnelAdd0函式會將新的網際網路通訊協定安全性 (IPsec) 通道模式原則新增至系統。

注意FwpmIPsecTunnelAdd0 是 Windows Vista 中使用的 FwpmIPsecTunnelAdd 的特定實作。 如需詳細資訊 ,請參閱 Version-Independent 名稱和以特定 Windows 版本為目標 。 針對 Windows 7, FwpmIPsecTunnelAdd1 可供使用。 針對 Windows 8, FwpmIPsecTunnelAdd2 可供使用。
 

語法

DWORD FwpmIPsecTunnelAdd0(
  [in]           HANDLE                       engineHandle,
  [in]           UINT32                       flags,
  [in, optional] const FWPM_PROVIDER_CONTEXT0 *mainModePolicy,
  [in]           const FWPM_PROVIDER_CONTEXT0 *tunnelPolicy,
  [in]           UINT32                       numFilterConditions,
  [in]           const FWPM_FILTER_CONDITION0 *filterConditions,
  [in, optional] PSECURITY_DESCRIPTOR         sd
);

參數

[in] engineHandle

類型: HANDLE

篩選引擎開啟會話的控制碼。 呼叫 FwpmEngineOpen0 以開啟篩選引擎的會話。

[in] flags

類型: UINT32

可能的值:

IPsec 通道旗標 意義
FWPM_TUNNEL_FLAG_POINT_TO_POINT
將點對點通道新增至系統。

[in, optional] mainModePolicy

類型: FWPM_PROVIDER_CONTEXT0*

IPsec 通道的主要模式原則。

[in] tunnelPolicy

類型: FWPM_PROVIDER_CONTEXT0*

IPsec 通道的快速模式原則。

[in] numFilterConditions

類型: UINT32

filterConditions參數中存在的篩選準則數目。

[in] filterConditions

類型: FWPM_FILTER_CONDITION0*

描述應該由 IPsec 進行通道之流量的篩選準則陣列。

[in, optional] sd

類型: PSECURITY_DESCRIPTOR

與 IPsec 通道相關聯的安全性資訊。

傳回值

類型: DWORD

傳回碼/值 描述
ERROR_SUCCESS
0
已成功新增 IPsec 通道模式原則。
FWP_E_INVALID_PARAMETER
0x80320035
未設定FWPM_TUNNEL_FLAG_POINT_TO_POINT,而且指定了本機/遠端位址以外的條件。
FWP_E_* 錯誤碼
0x80320001— 0x80320039
Windows 篩選平台 () 特定錯誤。 如需詳細資料,請參閱 一併參閱其錯誤碼
RPC_* 錯誤碼
0x80010001— 0x80010122
無法與遠端或本機防火牆引擎通訊。

備註

無法從唯讀交易內呼叫此函式。 它將會失敗 並FWP_E_INCOMPATIBLE_TXN。 如需交易的詳細資訊,請參閱 物件管理

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 fwpmu.h
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll

另請參閱

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT0