Partager via


Méthode INetFwRule ::get_Grouping (netfw.h)

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

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

Syntaxe

HRESULT get_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, vous pouvez également spécifier une description de groupe 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 10 000 « @youresources.dll,-11005 ».

Lorsque des chaînes indirectes au format « h » sont passées en tant que paramètres au Pare-feu Windows avec 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 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 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