Interface INetFwRule (netfw.h)
L’interface INetFwRule permet d’accéder aux propriétés d’une règle.
Héritage
L’interface INetFwRule hérite de l’interface IDispatch. INetFwRule a également les types de membres suivants :
Méthodes
L’interface INetFwRule utilise ces méthodes.
| INetFwRule ::get_Action Spécifie l’action d’une règle ou d’un paramètre par défaut. (INetFwRule.get_Action) |
| INetFwRule ::get_ApplicationName Spécifie le nom convivial de l’application à laquelle cette règle s’applique. (Get) |
| INetFwRule ::get_Description Spécifie la description de cette règle. (Get) |
| INetFwRule ::get_Direction Spécifie le sens du trafic auquel la règle s’applique. (Get) |
| INetFwRule ::get_EdgeTraversal Indique si la traversée de périmètre est activée ou désactivée pour cette règle. (Get) |
| INetFwRule ::get_Enabled Active ou désactive une règle. (Get) |
| INetFwRule ::get_Grouping Spécifie le groupe auquel appartient une règle individuelle. (Get) |
| INetFwRule ::get_IcmpTypesAndCodes Spécifie la liste des types et codes ICMP pour cette règle. (Get) |
| INetFwRule ::get_Interfaces Spécifie la liste des interfaces auxquelles la règle s’applique. (Get) |
| INetFwRule ::get_InterfaceTypes Spécifie la liste des types d’interface auxquels la règle s’applique. (Get) |
| INetFwRule ::get_LocalAddresses Spécifie la liste des adresses locales pour cette règle. (Get) |
| INetFwRule ::get_LocalPorts Spécifie la liste des ports locaux pour cette règle. (Get) |
| INetFwRule ::get_Name Spécifie le nom convivial de cette règle. (Get) |
| INetFwRule ::get_Profiles Spécifie les profils auxquels la règle appartient. (Get) |
| INetFwRule ::get_Protocol Spécifie le protocole IP de cette règle. (Get) |
| INetFwRule ::get_RemoteAddresses Spécifie la liste des adresses distantes pour cette règle. (Get) |
| INetFwRule ::get_RemotePorts Spécifie la liste des ports distants pour cette règle. (Get) |
| INetFwRule ::get_ServiceName Spécifie la propriété de nom de service de l’application. (Get) |
| INetFwRule ::p ut_Action Spécifie l’action d’une règle ou d’un paramètre par défaut. (INetFwRule.put_Action) |
| INetFwRule ::p ut_ApplicationName Spécifie le nom convivial de l’application à laquelle cette règle s’applique. (Put) |
| INetFwRule ::p ut_Description Spécifie la description de cette règle. (Put) |
| INetFwRule ::p ut_Direction Spécifie le sens du trafic auquel la règle s’applique. (Put) |
| INetFwRule ::p ut_EdgeTraversal Indique si la traversée de périmètre est activée ou désactivée pour cette règle. (Put) |
| INetFwRule ::p ut_Enabled Active ou désactive une règle. (Put) |
| INetFwRule ::p ut_Grouping Spécifie le groupe auquel appartient une règle individuelle. (Put) |
| INetFwRule ::p ut_IcmpTypesAndCodes Spécifie la liste des types et codes ICMP pour cette règle. (Put) |
| INetFwRule ::p ut_Interfaces Spécifie la liste des interfaces auxquelles la règle s’applique. (Put) |
| INetFwRule ::p ut_InterfaceTypes Spécifie la liste des types d’interface auxquels la règle s’applique. (Put) |
| INetFwRule ::p ut_LocalAddresses Spécifie la liste des adresses locales pour cette règle. (Put) |
| INetFwRule ::p ut_LocalPorts Spécifie la liste des ports locaux pour cette règle. (Put) |
| INetFwRule ::p ut_Name Spécifie le nom convivial de cette règle. (Put) |
| INetFwRule ::p ut_Profiles Spécifie les profils auxquels la règle appartient. (Put) |
| INetFwRule ::p ut_Protocol Spécifie le protocole IP de cette règle. (Put) |
| INetFwRule ::p ut_RemoteAddresses Spécifie la liste des adresses distantes pour cette règle. (Put) |
| INetFwRule ::p ut_RemotePorts Spécifie la liste des ports distants pour cette règle. (Put) |
| INetFwRule ::p ut_ServiceName Spécifie la propriété de nom de service de l’application. (Put) |
Remarques
Chaque fois que vous modifiez une propriété d’une règle, le Pare-feu Windows valide la règle et vérifie son exactitude. Par conséquent, lorsque vous modifiez une règle, vous devez effectuer les étapes dans un ordre spécifique. Par exemple, si vous ajoutez une règle ICMP, vous devez d’abord définir le protocole sur ICMP, puis ajouter la règle. Si ces étapes sont effectuées dans l’ordre inverse, une erreur se produit et la modification est perdue.
Si vous modifiez une règle de port TCP et que vous la convertissez en règle ICMP, supprimez d’abord le port, remplacez le protocole TCP par ICMP, puis ajoutez la règle.
Pour récupérer et modifier des règles existantes, les instances de cette interface doivent être récupérées via INetFwRules. Toutes les modifications de configuration ont lieu immédiatement.
Lorsque vous accédez aux propriétés d’une règle, gardez à l’esprit qu’il peut y avoir un petit délai avant qu’une règle nouvellement ajoutée soit appliquée.
Les propriétés sont utilisées pour créer des règles de pare-feu. La plupart des propriétés peuvent être utilisées afin de créer des règles de pare-feu très spécifiques.
| Propriété | Type et format | Contraintes |
|---|---|---|
| Nom | Chaîne de texte clair. | Obligatoire. La chaîne ne doit pas contenir de « | » et elle ne doit pas être « all ». |
| Description | Chaîne de texte clair. | facultatif. La chaîne ne doit pas contenir de « | ». |
| Regroupement | Chaîne au format « @<dll name>, <resource string identifier> ». | Obligatoire. |
| Activé | Boolean (VARIANT_BOOLEAN). | facultatif. La valeur par défaut est false (VARIANT_FALSE) si rien n’est spécifié. |
| ApplicationName | Chaîne de texte clair. | facultatif. |
| ServiceName | Chaîne de texte clair. | facultatif. |
| LocalPorts | Chaîne de texte clair contenant une liste de numéros de port. « RPC » est une valeur acceptable. | facultatif. |
| RemotePorts | Chaîne de texte clair contenant une liste de numéros de port. | facultatif. |
| Adresses locales | Chaîne de texte clair contenant une liste d’adresses IPv4 et IPv6 séparées par des virgules. Les valeurs de plage et « * » sont acceptables dans cette liste. | facultatif. |
| RemoteAddresses | Chaîne de texte clair contenant une liste d’adresses IPv4 et IPv6 séparées par des virgules. Les valeurs de plage et « * » sont acceptables dans cette liste. | facultatif. |
| Protocole | Number. | facultatif. |
| put_Profiles | Valeur de chaîne au format « type, code ». Plusieurs types et codes peuvent être inclus dans la chaîne en séparant chaque paire par un « ; ». | facultatif. |
| Interfaces | Tableau de chaînes contenant les noms conviviaux des interfaces. | facultatif. |
| InterfaceTypes | Valeur de chaîne. Plusieurs types d’interface peuvent être inclus dans la chaîne en séparant chaque valeur par un « , ». Les valeurs acceptables sont « RemoteAccess », « Wireless », « Lan » et « All ». | facultatif. |
| Sens | Énumération. | facultatif. |
| Action | Énumération. | facultatif. |
| EdgeTraversal | Boolean (VARIANT_BOOLEAN). | facultatif. |
| Profils | Énumération. | facultatif. |
Pour plus d’informations sur chaque propriété, consultez la rubrique correspondante.
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 |