Método INetFwRules::Add (netfw.h)
O método Add adiciona uma nova regra à coleção.
Sintaxe
HRESULT Add(
[in] INetFwRule *rule
);
Parâmetros
[in] rule
Regra a ser adicionada à coleção por meio de um objeto INetFwRule .
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 |
|---|---|
|
A operação foi anulada devido a problemas de permissões. |
|
O método falhou porque um parâmetro não era válido. |
|
O método falhou porque o objeto já está na coleção. |
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 |
|---|---|
|
A operação foi anulada devido a problemas de permissões. |
|
O método falhou porque um parâmetro não era válido. |
|
O método falhou porque o objeto já está na coleção. |
Comentários
Se já existir uma regra com o mesmo identificador de regra que a que está sendo enviada, a regra existente será substituída.
Adicionar uma regra de firewall com uma LocalAppPackageId especificada pode levar a um comportamento inesperado e não tem suporte.
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 |