Compartilhar via


Método INetFwRule::p ut_Grouping (netfw.h)

Especifica o grupo ao qual pertence uma regra individual.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_Grouping(
  BSTR context
);

Parâmetros

context

Valor retornado

Nenhum

Comentários

Essa propriedade é opcional.

Consulte também as restrições de alteração de propriedades descritas na seção Comentários da página interface INetFwRule .

O uso da propriedade Agrupamento é altamente recomendado, pois agrupa várias regras em uma única linha no painel de controle do Firewall do Windows. Isso permite que o usuário habilite ou desabilite várias regras com um único clique. A propriedade Grouping também pode ser especificada usando cadeias de caracteres indiretas. Nesse caso, também é possível especificar uma descrição de grupo que aparecerá nas propriedades do grupo de regras no painel de controle do Firewall do Windows. Por exemplo, se a cadeia de caracteres de grupo for especificada por uma cadeia de caracteres indireta no índice 1005 ("@yourresources.dll,-1005"), a descrição do grupo poderá ser especificada em uma cadeia de caracteres de recurso superior a 10000 "@youresources.dll,-11005".

Quando cadeias de caracteres indiretas na forma de "h" são passadas como parâmetros para o Firewall do Windows com APIs de Segurança Avançada, elas devem ser colocadas no diretório System32 windows ou especificadas por um caminho completo. Além disso, 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

INetFwRule