Interfaz INetFwRule (netfw.h)
La interfaz INetFwRule proporciona acceso a las propiedades de una regla.
Herencia
La interfaz INetFwRule hereda de la interfaz IDispatch . INetFwRule también tiene estos tipos de miembros:
Métodos
La interfaz INetFwRule tiene estos métodos.
| INetFwRule::get_Action Especifica la acción de una regla o configuración predeterminada. (INetFwRule.get_Action) |
| INetFwRule::get_ApplicationName Especifica el nombre descriptivo de la aplicación a la que se aplica esta regla. (Obtener) |
| INetFwRule::get_Description Especifica la descripción de esta regla. (Obtener) |
| INetFwRule::get_Direction Especifica la dirección del tráfico para el que se aplica la regla. (Obtener) |
| INetFwRule::get_EdgeTraversal Indica si el recorrido perimetral está habilitado o deshabilitado para esta regla. (Obtener) |
| INetFwRule::get_Enabled Habilita o deshabilita una regla. (Obtener) |
| INetFwRule::get_Grouping Especifica el grupo al que pertenece una regla individual. (Obtener) |
| INetFwRule::get_IcmpTypesAndCodes Especifica la lista de tipos y códigos ICMP para esta regla. (Obtener) |
| INetFwRule::get_Interfaces Especifica la lista de interfaces para las que se aplica la regla. (Obtener) |
| INetFwRule::get_InterfaceTypes Especifica la lista de tipos de interfaz para los que se aplica la regla. (Obtener) |
| INetFwRule::get_LocalAddresses Especifica la lista de direcciones locales para esta regla. (Obtener) |
| INetFwRule::get_LocalPorts Especifica la lista de puertos locales para esta regla. (Obtener) |
| INetFwRule::get_Name Especifica el nombre descriptivo de esta regla. (Obtener) |
| INetFwRule::get_Profiles Especifica los perfiles a los que pertenece la regla. (Obtener) |
| INetFwRule::get_Protocol Especifica el protocolo IP de esta regla. (Obtener) |
| INetFwRule::get_RemoteAddresses Especifica la lista de direcciones remotas para esta regla. (Obtener) |
| INetFwRule::get_RemotePorts Especifica la lista de puertos remotos para esta regla. (Obtener) |
| INetFwRule::get_ServiceName Especifica la propiedad de nombre de servicio de la aplicación. (Obtener) |
| INetFwRule::p ut_Action Especifica la acción de una regla o configuración predeterminada. (INetFwRule.put_Action) |
| INetFwRule::p ut_ApplicationName Especifica el nombre descriptivo de la aplicación a la que se aplica esta regla. (Put) |
| INetFwRule::p ut_Description Especifica la descripción de esta regla. (Put) |
| INetFwRule::p ut_Direction Especifica la dirección del tráfico para el que se aplica la regla. (Put) |
| INetFwRule::p ut_EdgeTraversal Indica si el recorrido perimetral está habilitado o deshabilitado para esta regla. (Put) |
| INetFwRule::p ut_Enabled Habilita o deshabilita una regla. (Put) |
| INetFwRule::p ut_Grouping Especifica el grupo al que pertenece una regla individual. (Put) |
| INetFwRule::p ut_IcmpTypesAndCodes Especifica la lista de tipos y códigos ICMP para esta regla. (Put) |
| INetFwRule::p ut_Interfaces Especifica la lista de interfaces para las que se aplica la regla. (Put) |
| INetFwRule::p ut_InterfaceTypes Especifica la lista de tipos de interfaz para los que se aplica la regla. (Put) |
| INetFwRule::p ut_LocalAddresses Especifica la lista de direcciones locales para esta regla. (Put) |
| INetFwRule::p ut_LocalPorts Especifica la lista de puertos locales para esta regla. (Put) |
| INetFwRule::p ut_Name Especifica el nombre descriptivo de esta regla. (Put) |
| INetFwRule::p ut_Profiles Especifica los perfiles a los que pertenece la regla. (Put) |
| INetFwRule::p ut_Protocol Especifica el protocolo IP de esta regla. (Put) |
| INetFwRule::p ut_RemoteAddresses Especifica la lista de direcciones remotas para esta regla. (Put) |
| INetFwRule::p ut_RemotePorts Especifica la lista de puertos remotos para esta regla. (Put) |
| INetFwRule::p ut_ServiceName Especifica la propiedad de nombre de servicio de la aplicación. (Put) |
Comentarios
Cada vez que cambia una propiedad de una regla, Firewall de Windows confirma la regla y la comprueba para que sea correcta. Como resultado, al editar una regla, debe realizar los pasos en un orden específico. Por ejemplo, si agrega una regla ICMP, primero debe establecer el protocolo en ICMP y, a continuación, agregar la regla. Si estos pasos se realizan en orden opuesto, se produce un error y se pierde el cambio.
Si va a editar una regla de puerto TCP y convertirlo en una regla ICMP, elimine primero el puerto, cambie el protocolo de TCP a ICMP y agregue la regla.
Para recuperar y modificar las reglas existentes, las instancias de esta interfaz se deben recuperar a través de INetFwRules. Todos los cambios de configuración se realizan inmediatamente.
Al acceder a las propiedades de una regla, tenga en cuenta que puede haber un retraso de tiempo pequeño antes de aplicar una regla recién agregada.
Las propiedades se usan para crear reglas de firewall. Muchas de las propiedades se pueden usar para crear reglas de firewall muy específicas.
| Propiedad | Tipo y formato | Restricciones |
|---|---|---|
| Nombre | Cadena de texto no cifrado. | Necesario. La cadena no debe contener "|" y no debe ser "all". |
| Descripción | Cadena de texto no cifrado. | Opcional. La cadena no debe contener "|". |
| Agrupación | Cadena con el formato "@<dll name>, <resource string identifier>". | Necesario. |
| Enabled | Boolean (VARIANT_BOOLEAN). | Opcional. El valor predeterminado es false (VARIANT_FALSE) si no se especifica nada. |
| ApplicationName | Cadena de texto no cifrado. | Opcional. |
| ServiceName | Cadena de texto no cifrado. | Opcional. |
| LocalPorts | Cadena de texto no cifrado que contiene una lista de números de puerto. "RPC" es un valor aceptable. | Opcional. |
| RemotePorts | Cadena de texto no cifrado que contiene una lista de números de puerto. | Opcional. |
| LocalAddresses | Cadena de texto no cifrado que contiene una lista de direcciones IPv4 e IPv6 separadas por comas. Los valores de rango y "*" son aceptables en esta lista. | Opcional. |
| RemoteAddresses | Cadena de texto no cifrado que contiene una lista de direcciones IPv4 e IPv6 separadas por comas. Los valores de rango y "*" son aceptables en esta lista. | Opcional. |
| Protocolo | Número. | Opcional. |
| put_Profiles | Valor de cadena con el formato "type, code". Se pueden incluir varios tipos y códigos en la cadena separando cada par con un ";". | Opcional. |
| Interfaces | Matriz de cadenas que contienen los nombres descriptivos de las interfaces. | Opcional. |
| InterfaceTypes | Valor de cadena. Se pueden incluir varios tipos de interfaz en la cadena separando cada valor con un elemento ",". Los valores aceptables son "RemoteAccess", "Wireless", "Lan" y "All". | Opcional. |
| Dirección | Enumeración. | Opcional. |
| Acción | Enumeración. | Opcional. |
| EdgeTraversal | Boolean (VARIANT_BOOLEAN). | Opcional. |
| Perfiles | Enumeración. | Opcional. |
Para obtener información adicional sobre cada propiedad, consulte el tema correspondiente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | netfw.h |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de