Método INetFwRules::Add (netfw.h)

El método Add agrega una nueva regla a la colección.

Sintaxis

HRESULT Add(
  [in] INetFwRule *rule
);

[in] rule

Regla que se va a agregar a la colección a través de un objeto INetFwRule .

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
E_ACCESSDENIED	La operación se anuló debido a problemas de permisos.
E_INVALIDARG	Error en el método porque un parámetro no era válido.
E_UNEXPECTED	Error en el método porque el objeto ya está en la colección.

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
E_ACCESSDENIED	La operación se anuló debido a problemas de permisos.
E_INVALIDARG	Error en el método porque un parámetro no era válido.
E_UNEXPECTED	Error en el método porque el objeto ya está en la colección.

Si ya existe una regla con el mismo identificador de regla que el que se envía, se sobrescribe la regla existente.

Agregar una regla de firewall con un localAppPackageId especificado puede provocar un comportamiento inesperado y no se admite.

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netfw.h
Archivo DLL	FirewallAPI.dll