Compartilhar via

Método INetFwPolicy2::EnableRuleGroup (netfw.h)

  • Artigo

O método EnableRuleGroup habilita ou desabilita um grupo especificado de regras de firewall.

Sintaxe

HRESULT EnableRuleGroup(
  [in] long         profileTypesBitmask,
  [in] BSTR         group,
  [in] VARIANT_BOOL enable
);

Parâmetros

[in] profileTypesBitmask

Uma máscara de bits de perfis de NET_FW_PROFILE_TYPE2.

[in] group

Uma cadeia de caracteres que foi usada para agrupar regras. Pode ser o nome do grupo ou uma cadeia de caracteres indireta para o nome do grupo na forma de "@C:\Arquivos de Programas\Contoso Storefront\StorefrontRes.dll,-1234". As regras que pertencem a esse grupo seriam habilitadas ou desabilitadas.

[in] enable

Indica se o grupo de regras identificado pelo parâmetro group deve ser habilitado ou desabilitado.

Se esse valor for definido como true (VARIANT_TRUE), o grupo de regras será habilitado; caso contrário, o grupo será desabilitado.

Retornar valor

C++

Se o método tiver êxito, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
E_ACCESSDENIED
 A operação foi anulada devido a problemas de permissões.
E_INVALIDARG
 O método falhou devido a um parâmetro inválido.
S_FALSE
 O grupo solicitado não existe.
 

VB

Se o método tiver êxito, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
E_ACCESSDENIED
 A operação foi anulada devido a problemas de permissões.
E_INVALIDARG
 O método falhou devido a um parâmetro inválido.
S_FALSE
 O grupo solicitado não existe.

Comentários

Quando cadeias de caracteres indiretas na forma de "@C:\Arquivos de Programas\Contoso Storefront\StorefrontRes.dll,-1234" são passadas como parâmetros para o Firewall do Windows com APIs de Segurança Avançada, elas devem ser especificadas por um caminho completo. O arquivo deve ter um acesso seguro que permita o acesso de leitura da conta de Serviço Local para permitir que o Serviço de Firewall do Windows leia as cadeias de caracteres. Para evitar que entidades de segurança sem privilégios modifiquem as cadeias de caracteres, as DLLs só devem permitir o acesso de gravação à conta de Administrador.

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
DLL FirewallAPI.dll

Confira também

INetFwPolicy2

Criação de regra