Partager via


Méthode INetFwRule ::p ut_Grouping (netfw.h)

Spécifie le groupe auquel appartient une règle individuelle.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_Grouping(
  BSTR context
);

Paramètres

context

Valeur de retour

None

Remarques

Cette propriété est facultative.

Consultez également les restrictions relatives à la modification des propriétés décrites dans la section Remarques de la page d’interface INetFwRule .

L’utilisation de la propriété Grouping est fortement recommandée, car elle regroupe plusieurs règles en une seule ligne dans le panneau de configuration du Pare-feu Windows. Cela permet à l’utilisateur d’activer ou de désactiver plusieurs règles en un seul clic. La propriété Grouping peut également être spécifiée à l’aide de chaînes indirectes. Dans ce cas, une description de groupe peut également être spécifiée qui apparaîtra dans les propriétés du groupe de règles dans le panneau de configuration du Pare-feu Windows. Par exemple, si la chaîne de groupe est spécifiée par une chaîne indirecte à l’index 1005 (« @yourresources.dll,-1005 »), la description du groupe peut être spécifiée à une chaîne de ressources supérieure de 10000 « @youresources.dll,-11005 ».

Lorsque des chaînes indirectes sous la forme « h » sont transmises en tant que paramètres au Pare-feu Windows avec les API de sécurité avancée, elles doivent être placées sous le répertoire Windows System32 ou spécifiées par un chemin d’accès complet. En outre, le fichier doit disposer d’un accès sécurisé qui permet au compte de service local d’accéder en lecture pour permettre au service de pare-feu Windows de lire les chaînes. Pour éviter que les principaux de sécurité non privilégiés modifient les chaînes, les DLL doivent uniquement autoriser l’accès en écriture au compte d’administrateur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête netfw.h
DLL FirewallAPI.dll

Voir aussi

INetFwRule