INetFwRule::get_Grouping メソッド (netfw.h)
個々のルールが属するグループを指定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT get_Grouping(
BSTR *context
);
パラメーター
context
戻り値
なし
解説
このプロパティは省略可能です。
また、 INetFwRule インターフェイス ページの「解説」セクションで説明されているプロパティの変更に関する制限も参照してください。
複数のルールを Windows ファイアウォール コントロール パネルの 1 行にグループ化しているため、Grouping プロパティの使用を強くお勧めします。 これにより、ユーザーは 1 回のクリックで複数のルールを有効または無効にすることができます。 Grouping プロパティは、間接文字列を使用して指定することもできます。 この場合、Windows ファイアウォールコントロール パネルのルール グループ プロパティに表示されるグループの説明を指定することもできます。 たとえば、グループ文字列がインデックス 1005 ("@yourresources.dll,-1005" の間接文字列で指定されている場合、グループの説明は 10000 "@youresources.dll,-11005" のリソース文字列で指定できます。
"h" の形式の間接文字列が、Advanced Security API を使用して Windows ファイアウォールにパラメーターとして渡される場合は、System32 Windows ディレクトリの下に配置するか、完全なパスで指定する必要があります。 さらに、ファイルには、Windows ファイアウォール サービスが文字列を読み取ることができるようにローカル サービス アカウントの読み取りアクセスを許可するセキュリティで保護されたアクセス権が必要です。 特権のないセキュリティ プリンシパルによる文字列の変更を回避するために、DLL では管理者アカウントへの書き込みアクセスのみを許可する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | netfw.h |
| [DLL] | FirewallAPI.dll |