共用方式為

FwpmConnectionPolicyAdd0 函式 (fwpmu.h)

  • 發行項

TCP/IP 堆疊支持輸出連線的目的地位址型路由。 FwpmConnectionPolicyAdd0API 可讓您為輸出連線設定更具表達性的路由原則，進而啟用更複雜的案例，例如來源位址型路由、進程型路由、埠型路由等等。 聯機原則包含比對條件陣列、路由設定陣列，以及相關聯的權數。 您可以設定多個原則，並根據輸出連線的設定權數進行評估， (較高的權數優先) 。 套用輸出連線 (ANDed) 之第一個原則的路由設定。

語法

DWORD FwpmConnectionPolicyAdd0(
  HANDLE                       engineHandle,
  const FWPM_PROVIDER_CONTEXT3 *connectionPolicy,
  FWP_IP_VERSION               ipVersion,
  UINT64                       weight,
  UINT32                       numFilterConditions,
  const FWPM_FILTER_CONDITION0 *filterConditions,
  PSECURITY_DESCRIPTOR         sd
);

參數

engineHandle

類型：_In_ HANDLE

使用篩選引擎開啟之會話的句柄。 若要使用篩選引擎開啟會話，請呼叫 FwpmEngineOpen0。

connectionPolicy

類型：_In_ const FWPM_PROVIDER_CONTEXT3*

與提供者內容相關聯的狀態。

ipVersion

類型：_In_ FWP_IP_VERSION

流量的IP版本。

weight

類型： _In_ UINT64

指定相較於任何對等，應該提供此信任中繼代理程式 (TIA) 的權數。

numFilterConditions

類型：_In_ UINT32

filterConditions 中的元素數目。

filterConditions

類型：_In_reads_ (numFilterConditions) const FWPM_FILTER_CONDITION0*

必須為 true 的篩選條件，才能採取動作。

在可能的比對條件中， (請參閱 篩選條件標識碼) ，FwpmConnectionPolicyAdd0 支援下列清單中的標識符。 在 FWPM_FILTER_CONDITION0：：fieldKey 中設定這些值。

  • FWPM_CONDITION_ALE_APP_ID
  • FWPM_CONDITION_ALE_USER_ID
  • FWPM_CONDITION_IP_LOCAL_ADDRESS
  • FWPM_CONDITION_IP_LOCAL_ADDRESS_TYPE
  • FWPM_CONDITION_IP_LOCAL_PORT
  • FWPM_CONDITION_IP_PROTOCOL
  • FWPM_CONDITION_IP_REMOTE_ADDRESS
  • FWPM_CONDITION_IP_DESTINATION_ADDRESS_TYPE
  • FWPM_CONDITION_IP_REMOTE_PORT
  • FWPM_CONDITION_FLAGS
  • FWPM_CONDITION_ALE_ORIGINAL_APP_ID
  • FWPM_CONDITION_ALE_PACKAGE_ID
  • FWPM_CONDITION_COMPARTMENT_ID

sd

類型：_In_opt_ PSECURITY_DESCRIPTOR

安全性資訊。

備註

以下是支援的路由設定， (請參閱 FWP_NETWORK_CONNECTION_POLICY_SETTING_TYPE) ：

FWP_NETWORK_CONNECTION_POLICY_SOURCE_ADDRESS。 要用於連線的來源位址。 此值應該是 IPv4 位址 的FWP_UINT32 ，以及 IPv6 位址 的FWP_BYTE_ARRAY16_TYPE 。

FWP_NETWORK_CONNECTION_POLICY_NEXT_HOP_INTERFACE。 要用於連線之傳出介面的 LUID。 此值應該是 FWP_UINT64。

FWP_NETWORK_CONNECTION_POLICY_NEXT_HOP。 下一個hop 位址 (或閘道) 用於連線。 此值應該是 IPv4 位址 的FWP_UINT32 ，以及 IPv6 位址 的FWP_BYTE_ARRAY16_TYPE 。

規格需求

需求 值
標頭 fwpmu.h
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll