Interface INetFwRule (netfw.h)
A interface INetFwRule fornece acesso às propriedades de uma regra.
Herança
A interface INetFwRule herda da interface IDispatch . INetFwRule também tem estes tipos de membros:
Métodos
A interface INetFwRule tem esses métodos.
| INetFwRule::get_Action Especifica a ação para uma regra ou configuração padrão. (INetFwRule.get_Action) |
| INetFwRule::get_ApplicationName Especifica o nome amigável do aplicativo ao qual essa regra se aplica. (Obter) |
| INetFwRule::get_Description Especifica a descrição dessa regra. (Obter) |
| INetFwRule::get_Direction Especifica a direção do tráfego para o qual a regra se aplica. (Obter) |
| INetFwRule::get_EdgeTraversal Indica se a passagem de borda está habilitada ou desabilitada para essa regra. (Obter) |
| INetFwRule::get_Enabled Habilita ou desabilita uma regra. (Obter) |
| INetFwRule::get_Grouping Especifica o grupo ao qual pertence uma regra individual. (Obter) |
| INetFwRule::get_IcmpTypesAndCodes Especifica a lista de tipos e códigos ICMP para essa regra. (Obter) |
| INetFwRule::get_Interfaces Especifica a lista de interfaces para as quais a regra se aplica. (Obter) |
| INetFwRule::get_InterfaceTypes Especifica a lista de tipos de interface para os quais a regra se aplica. (Obter) |
| INetFwRule::get_LocalAddresses Especifica a lista de endereços locais para essa regra. (Obter) |
| INetFwRule::get_LocalPorts Especifica a lista de portas locais para essa regra. (Obter) |
| INetFwRule::get_Name Especifica o nome amigável dessa regra. (Obter) |
| INetFwRule::get_Profiles Especifica os perfis aos quais a regra pertence. (Obter) |
| INetFwRule::get_Protocol Especifica o protocolo IP dessa regra. (Obter) |
| INetFwRule::get_RemoteAddresses Especifica a lista de endereços remotos para essa regra. (Obter) |
| INetFwRule::get_RemotePorts Especifica a lista de portas remotas para essa regra. (Obter) |
| INetFwRule::get_ServiceName Especifica a propriedade de nome de serviço do aplicativo. (Obter) |
| INetFwRule::p ut_Action Especifica a ação para uma regra ou configuração padrão. (INetFwRule.put_Action) |
| INetFwRule::p ut_ApplicationName Especifica o nome amigável do aplicativo ao qual essa regra se aplica. (Put) |
| INetFwRule::p ut_Description Especifica a descrição dessa regra. (Put) |
| INetFwRule::p ut_Direction Especifica a direção do tráfego para o qual a regra se aplica. (Put) |
| INetFwRule::p ut_EdgeTraversal Indica se a passagem de borda está habilitada ou desabilitada para essa regra. (Put) |
| INetFwRule::p ut_Enabled Habilita ou desabilita uma regra. (Put) |
| INetFwRule::p ut_Grouping Especifica o grupo ao qual pertence uma regra individual. (Put) |
| INetFwRule::p ut_IcmpTypesAndCodes Especifica a lista de tipos e códigos ICMP para essa regra. (Put) |
| INetFwRule::p ut_Interfaces Especifica a lista de interfaces para as quais a regra se aplica. (Put) |
| INetFwRule::p ut_InterfaceTypes Especifica a lista de tipos de interface para os quais a regra se aplica. (Put) |
| INetFwRule::p ut_LocalAddresses Especifica a lista de endereços locais para essa regra. (Put) |
| INetFwRule::p ut_LocalPorts Especifica a lista de portas locais para essa regra. (Put) |
| INetFwRule::p ut_Name Especifica o nome amigável dessa regra. (Put) |
| INetFwRule::p ut_Profiles Especifica os perfis aos quais a regra pertence. (Put) |
| INetFwRule::p ut_Protocol Especifica o protocolo IP dessa regra. (Put) |
| INetFwRule::p ut_RemoteAddresses Especifica a lista de endereços remotos para essa regra. (Put) |
| INetFwRule::p ut_RemotePorts Especifica a lista de portas remotas para essa regra. (Put) |
| INetFwRule::p ut_ServiceName Especifica a propriedade de nome de serviço do aplicativo. (Put) |
Comentários
Sempre que você altera uma propriedade de uma regra, o Firewall do Windows confirma a regra e a verifica quanto à correção. Como resultado, ao editar uma regra, você deve executar as etapas em uma ordem específica. Por exemplo, se você adicionar uma regra ICMP, deverá primeiro definir o protocolo como ICMP e, em seguida, adicionar a regra. Se essas etapas forem executadas na ordem oposta, ocorrerá um erro e a alteração será perdida.
Se você estiver editando uma regra de porta TCP e convertendo-a em uma regra ICMP, primeiro exclua a porta, altere o protocolo de TCP para ICMP e adicione a regra.
Para recuperar e modificar as regras existentes, as instâncias dessa interface devem ser recuperadas por meio de INetFwRules. Todas as alterações de configuração ocorrem imediatamente.
Ao acessar as propriedades de uma regra, tenha em mente que pode haver um pequeno atraso de tempo antes que uma regra recém-adicionada seja aplicada.
As propriedades são usadas para criar regras de firewall. Muitas das propriedades podem ser usadas para criar regras de firewall muito específicas.
| Propriedade | Tipo e formato | Restrições |
|---|---|---|
| Nome | Limpar cadeia de caracteres de texto. | Obrigatórios. A cadeia de caracteres não deve conter um "|" e não deve ser "tudo". |
| Descrição | Limpar cadeia de caracteres de texto. | Opcional. A cadeia de caracteres não deve conter um "|". |
| Agrupamento | Cadeia de caracteres no formato "@<dll name>, <resource string identifier>". | Obrigatórios. |
| Enabled | Booliano (VARIANT_BOOLEAN). | Opcional. O padrão será false (VARIANT_FALSE) se nada for especificado. |
| ApplicationName | Limpar cadeia de caracteres de texto. | Opcional. |
| ServiceName | Limpar cadeia de caracteres de texto. | Opcional. |
| LocalPorts | Desmarque a cadeia de caracteres de texto que contém uma lista de números de porta. "RPC" é um valor aceitável. | Opcional. |
| RemotePorts | Desmarque a cadeia de caracteres de texto que contém uma lista de números de porta. | Opcional. |
| LocalAddresses | Desmarque a cadeia de caracteres de texto que contém uma lista de endereços IPv4 e IPv6 separados por vírgulas. Os valores de intervalo e"*"são aceitáveis nesta lista. | Opcional. |
| RemoteAddresses | Desmarque a cadeia de caracteres de texto que contém uma lista de endereços IPv4 e IPv6 separados por vírgulas. Os valores de intervalo e"*"são aceitáveis nesta lista. | Opcional. |
| Protocolo | Número. | Opcional. |
| put_Profiles | Valor de cadeia de caracteres no formato "tipo, código". Vários tipos e códigos podem ser incluídos na cadeia de caracteres separando cada par com um ";". | Opcional. |
| Interfaces | Matriz de cadeias de caracteres que contém os nomes amigáveis das interfaces. | Opcional. |
| Interfacetypes | Valor da cadeia de caracteres. Vários tipos de interface podem ser incluídos na cadeia de caracteres separando cada valor com um "". Os valores aceitáveis são "RemoteAccess", "Wireless", "Lan" e "All". | Opcional. |
| Direção | Enumeração. | Opcional. |
| Ação | Enumeração. | Opcional. |
| EdgeTraversal | Booliano (VARIANT_BOOLEAN). | Opcional. |
| Perfis | Enumeração. | Opcional. |
Para obter informações adicionais sobre cada propriedade, consulte o tópico correspondente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | netfw.h |