Compartilhar via

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

  • Artigo

O método get_IsRuleGroupCurrentlyEnabled determina se um grupo especificado de regras de firewall está habilitado ou desabilitado para o perfil atual.

Sintaxe

HRESULT get_IsRuleGroupCurrentlyEnabled(
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

Parâmetros

[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 pertencentes a esse grupo seriam consultadas.

[out] enabled

Indica se o grupo de regras identificado pelo parâmetro de grupo está habilitado ou desabilitado.

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

Para o Windows 7 e posteriores, esse valor será definido como true (VARIANT_TRUE) se o grupo de regras estiver habilitado em pelo menos um perfil ativo.

Retornar valor

C++

Se o método for bem-sucedido, 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
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.
E_POINTER
 O método falhou porque um ponteiro era inválido.
 

Para o Windows 7 e posteriores, se vários perfis estiverem ativos e os perfis tiverem respostas diferentes para IsRuleGroupCurrentlyEnabled, o valor retornado será S_FALSE; se os perfis tiverem a mesma resposta para IsRuleGroupCurrentlyEnabled, o valor retornado será S_TRUE.

VB

Essa chamada retorna uma status de habilitação booliana que indica se o grupo de regras identificado pelo parâmetro de grupo está 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.

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 que o acesso de leitura da conta de Serviço Local permita que o Serviço de Firewall do Windows leia as cadeias de caracteres. Para evitar que entidades de segurança não privilegiadas modifiquem as cadeias de caracteres, as DLLs só devem permitir 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