Método INetFwAuthorizedApplications::Add (netfw.h)
[La API de Firewall de Windows está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Para Windows Vista y versiones posteriores, se recomienda usar firewall de Windows con la API de seguridad avanzada .
El método Add agrega una nueva aplicación a la colección.
Sintaxis
HRESULT Add(
[in] INetFwAuthorizedApplication *app
);
Parámetros
[in] app
| C++ | Aplicación que se va a agregar a la colección a través de un objeto INetFWAuthorizedApplication . |
| VB | Aplicación que se va a agregar a la colección a través de un objeto INetFWAuthorizedApplication . |
Valor devuelto
C++
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 |
|---|---|
|
La operación se anuló debido a problemas de permisos. |
|
Error en el método porque un parámetro no era válido. |
|
El método no pudo asignar la memoria necesaria. |
|
Error en el método porque el objeto ya está en la colección. |
VB
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 |
|---|---|
|
La operación se anuló debido a problemas de permisos. |
|
Error en el método porque un parámetro no era válido. |
|
El método no pudo asignar la memoria necesaria. |
|
Error en el método porque el objeto ya está en la colección. |
Comentarios
Si ya existe una aplicación con la misma ruta de acceso, se sobrescriben las opciones de configuración existentes.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | netfw.h |
| Archivo DLL | FirewallAPI.dll; Hnetcfg.dll en Windows XP con SP2 |