Метод INetFwAuthorizedApplications::Add (netfw.h)
[API брандмауэра Windows доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Для Windows Vista и более поздних версий рекомендуется использовать API брандмауэра Windows в режиме повышенной безопасности .]
Метод Add добавляет новое приложение в коллекцию.
Синтаксис
HRESULT Add(
[in] INetFwAuthorizedApplication *app
);
Параметры
[in] app
| C++ | Приложение для добавления в коллекцию с помощью объекта INetFWAuthorizedApplication . |
| VB | Приложение для добавления в коллекцию с помощью объекта INetFWAuthorizedApplication . |
Возвращаемое значение
C++
Если метод завершается успешно, возвращается значение S_OK.Если метод завершается ошибкой, возвращается один из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Операция была прервана из-за проблем с разрешениями. |
|
Сбой метода, так как параметр был недопустимым. |
|
Методу не удалось выделить необходимую память. |
|
Сбой метода, так как объект уже находится в коллекции. |
VB
Если метод завершается успешно, возвращается значение S_OK.Если метод завершается ошибкой, возвращается один из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Операция была прервана из-за проблем с разрешениями. |
|
Сбой метода, так как параметр был недопустимым. |
|
Методу не удалось выделить необходимую память. |
|
Сбой метода, так как объект уже находится в коллекции. |
Комментарии
Если приложение с таким же путем уже существует, существующие параметры перезаписываются.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения] |
| Целевая платформа | Windows |
| Header | netfw.h |
| DLL | FirewallAPI.dll; Hnetcfg.dll в Windows XP с пакетом обновления 2 (SP2) |