(netfw.h) INetFwRule 介面
INetFwRule 介面可讓您存取規則的屬性。
繼承
INetFwRule 介面繼承自 IDispatch 介面。 INetFwRule 也有下列類型的成員：
方法
INetFwRule 介面具有這些方法。
備註
每次變更規則的屬性時，Windows 防火牆都會認可規則，並驗證規則是否正確。 因此，當您編輯規則時，必須依特定順序執行步驟。 例如，如果您新增ICMP規則，您必須先將通訊協定設定為ICMP，然後新增規則。 如果這些步驟採用相反的順序，就會發生錯誤，而且變更會遺失。
如果您要編輯 TCP 連接埠規則並將它轉換成 ICMP 規則，請先刪除埠、將通訊協定從 TCP 變更為 ICMP，然後新增規則。
若要擷取和修改現有的規則，必須透過 INetFwRules 擷取此介面的實例。 所有組態變更都會立即發生。
存取規則的屬性時，請記住，在套用新加入的規則之前，可能會有一小段時間延遲。
屬性可用來建立防火牆規則。 許多屬性可用來建立非常特定的防火牆規則。
| 屬性 | 類型和格式 | 條件約束 |
|---|---|---|
| 名稱 | 純文字字串。 | 必要。 字串不得包含 “|”，而且不得為 “all”。 |
| 描述 | 純文字字串。 | 選擇性。 字串不得包含 “|”。 |
| 分組 | 格式為 “@<dll name>， <resource string identifier>” 的字串。 | 必要。 |
| 啟用 | 布爾值 (VARIANT_BOOLEAN) 。 | 選擇性。 如果未指定任何專案，則預設為 false (VARIANT_FALSE) 。 |
| ApplicationName | 純文字字串。 | 選擇性。 |
| ServiceName | 純文字字串。 | 選擇性。 |
| LocalPorts | 包含埠號碼清單的純文字字串。 “RPC” 是可接受的值。 | 選擇性。 |
| RemotePorts | 包含埠號碼清單的純文字字串。 | 選擇性。 |
| LocalAddresses | 純文字字串，其中包含以逗號分隔的IPv4和IPv6位址清單。 此清單中可接受範圍值和“ *」。 | 選擇性。 |
| RemoteAddresses | 純文字字串，其中包含以逗號分隔的IPv4和IPv6位址清單。 此清單中可接受範圍值和“ *」。 | 選擇性。 |
| 通訊協定 | Number。 | 選擇性。 |
| put_Profiles | 格式為 「type， code」 的字串值。 您可以在字串中包含多個類型和程式代碼，方法是將每對與 “;” 分隔。 | 選擇性。 |
| 介面 | 包含介面易記名稱的字串數位。 | 選擇性。 |
| InterfaceTypes | 字串值。 將每個值與 “，”分隔，即可在字串中包含多個介面類型。 可接受的值為 “RemoteAccess”、“Wireless”、“Lan” 和 “All”。 | 選擇性。 |
| 方向 | 列舉。 | 選擇性。 |
| 動作 | 列舉。 | 選擇性。 |
| EdgeTraversal | 布爾值 (VARIANT_BOOLEAN) 。 | 選擇性。 |
| 設定檔 | 列舉。 | 選擇性。 |
如需每個屬性的其他資訊，請參閱對應的主題。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | netfw.h |