INetFwRule インターフェイス (netfw.h)
INetFwRule インターフェイスは、ルールのプロパティへのアクセスを提供します。
継承
INetFwRule インターフェイスは、IDispatch インターフェイスから継承されます。 INetFwRule には、次の種類のメンバーもあります。
メソッド
INetFwRule インターフェイスには、これらのメソッドがあります。
| INetFwRule::get_Action ルールまたは既定の設定のアクションを指定します。 (INetFwRule.get_Action) |
| INetFwRule::get_ApplicationName この規則を適用するアプリケーションのフレンドリ名を指定します。 (Get) |
| INetFwRule::get_Description この規則の説明を指定します。 (Get) |
| INetFwRule::get_Direction ルールが適用されるトラフィックの方向を指定します。 (Get) |
| INetFwRule::get_EdgeTraversal このルールに対してエッジ トラバーサルが有効か無効かを示します。 (Get) |
| INetFwRule::get_Enabled ルールを有効または無効にします。 (Get) |
| INetFwRule::get_Grouping 個々のルールが属するグループを指定します。 (Get) |
| INetFwRule::get_IcmpTypesAndCodes この規則の ICMP の種類とコードの一覧を指定します。 (Get) |
| INetFwRule::get_Interfaces ルールが適用されるインターフェイスの一覧を指定します。 (Get) |
| INetFwRule::get_InterfaceTypes ルールが適用されるインターフェイスの種類の一覧を指定します。 (Get) |
| INetFwRule::get_LocalAddresses この規則のローカル アドレスの一覧を指定します。 (Get) |
| INetFwRule::get_LocalPorts この規則のローカル ポートの一覧を指定します。 (Get) |
| INetFwRule::get_Name このルールのフレンドリ名を指定します。 (Get) |
| INetFwRule::get_Profiles ルールが属するプロファイルを指定します。 (Get) |
| INetFwRule::get_Protocol この規則の IP プロトコルを指定します。 (Get) |
| INetFwRule::get_RemoteAddresses この規則のリモート アドレスの一覧を指定します。 (Get) |
| INetFwRule::get_RemotePorts この規則のリモート ポートの一覧を指定します。 (Get) |
| INetFwRule::get_ServiceName アプリケーションのサービス名プロパティを指定します。 (Get) |
| INetFwRule::p ut_Action ルールまたは既定の設定のアクションを指定します。 (INetFwRule.put_Action) |
| INetFwRule::p ut_ApplicationName この規則を適用するアプリケーションのフレンドリ名を指定します。 (Put) |
| INetFwRule::p ut_Description この規則の説明を指定します。 (Put) |
| INetFwRule::p ut_Direction ルールが適用されるトラフィックの方向を指定します。 (Put) |
| INetFwRule::p ut_EdgeTraversal このルールに対してエッジ トラバーサルが有効か無効かを示します。 (Put) |
| INetFwRule::p ut_Enabled ルールを有効または無効にします。 (Put) |
| INetFwRule::p ut_Grouping 個々のルールが属するグループを指定します。 (Put) |
| INetFwRule::p ut_IcmpTypesAndCodes この規則の ICMP の種類とコードの一覧を指定します。 (Put) |
| INetFwRule::p ut_Interfaces ルールが適用されるインターフェイスの一覧を指定します。 (Put) |
| INetFwRule::p ut_InterfaceTypes ルールが適用されるインターフェイスの種類の一覧を指定します。 (Put) |
| INetFwRule::p ut_LocalAddresses この規則のローカル アドレスの一覧を指定します。 (Put) |
| INetFwRule::p ut_LocalPorts この規則のローカル ポートの一覧を指定します。 (Put) |
| INetFwRule::p ut_Name このルールのフレンドリ名を指定します。 (Put) |
| INetFwRule::p ut_Profiles ルールが属するプロファイルを指定します。 (Put) |
| INetFwRule::p ut_Protocol この規則の IP プロトコルを指定します。 (Put) |
| INetFwRule::p ut_RemoteAddresses この規則のリモート アドレスの一覧を指定します。 (Put) |
| INetFwRule::p ut_RemotePorts この規則のリモート ポートの一覧を指定します。 (Put) |
| INetFwRule::p ut_ServiceName アプリケーションのサービス名プロパティを指定します。 (Put) |
注釈
ルールのプロパティを変更するたびに、Windows ファイアウォールによってルールがコミットされ、正しいかどうかが検証されます。 その結果、ルールを編集するときは、特定の順序で手順を実行する必要があります。 たとえば、ICMP 規則を追加する場合は、まずプロトコルを ICMP に設定してから、規則を追加する必要があります。 これらの手順が逆の順序で実行されると、エラーが発生し、変更が失われます。
TCP ポート規則を編集して ICMP 規則に変換する場合は、まずポートを削除し、プロトコルを TCP から ICMP に変更してから、規則を追加します。
既存のルールを取得および変更するには、このインターフェイスのインスタンスを INetFwRules 経由で取得する必要があります。 すべての構成変更は直ちに行われます。
ルールのプロパティにアクセスする場合は、新しく追加されたルールが適用される前にタイム ラグが少ない可能性があることに注意してください。
プロパティは、ファイアウォール規則を作成するために使用されます。 プロパティの多くは、非常に具体的なファイアウォール規則を作成するために使用できます。
| プロパティ | 型と形式 | 制約 |
|---|---|---|
| 名前 | テキスト文字列をクリアします。 | 必須。 文字列に "|" を含めず、"all" にすることはできません。 |
| 説明 | テキスト文字列をクリアします。 | 省略可能。 文字列に "|" を含めてはいけません。 |
| グループ化 | "@<dll 名>、 <リソース文字列識別子>" の形式の文字列。 | 必須。 |
| 有効 | Boolean (VARIANT_BOOLEAN)。 | 省略可能。 何も指定されていない場合、既定値は false (VARIANT_FALSE) です。 |
| ApplicationName | テキスト文字列をクリアします。 | 省略可能。 |
| ServiceName | テキスト文字列をクリアします。 | 省略可能。 |
| LocalPorts | ポート番号の一覧を含むクリア テキスト文字列。 "RPC" は許容される値です。 | 省略可能。 |
| RemotePorts | ポート番号の一覧を含むクリア テキスト文字列。 | 省略可能。 |
| LocalAddresses | IPv4 アドレスと IPv6 アドレスの一覧をコンマで区切って含むクリア テキスト文字列。 範囲の値と"*"は、この一覧で使用できます。 | 省略可能。 |
| RemoteAddresses | IPv4 アドレスと IPv6 アドレスの一覧をコンマで区切って含むクリア テキスト文字列。 範囲の値と"*"は、この一覧で使用できます。 | 省略可能。 |
| プロトコル | 数値。 | 省略可能。 |
| put_Profiles | "type, code" という形式の文字列値。 文字列には、各ペアを ";" で区切ることで、複数の型とコードを含めることができます。 | 省略可能。 |
| インターフェイス | インターフェイスのフレンドリ名を含む文字列の配列。 | 省略可能。 |
| InterfaceTypes | 文字列値。 文字列には、各値を "," で区切ることで、複数のインターフェイス型を含めることができます。 使用できる値は、"RemoteAccess"、"Wireless"、"Lan"、および "All" です。 | 省略可能。 |
| 方向 | 列挙値。 | 省略可能。 |
| 操作 | 列挙値。 | 省略可能。 |
| EdgeTraversal | Boolean (VARIANT_BOOLEAN)。 | 省略可能。 |
| Profiles | 列挙値。 | 省略可能。 |
各プロパティの詳細については、対応するトピックを参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | netfw.h |