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