Поделиться через

Метод INetFwRules::Add (netfw.h)

  • Статья

Метод Add добавляет новое правило в коллекцию.

Синтаксис

HRESULT Add(
  [in] INetFwRule *rule
);

Параметры

[in] rule

Правило, добавляемое в коллекцию с помощью объекта INetFwRule .

Возвращаемое значение

C++

Если метод завершается успешно, возвращается значение S_OK.

Если метод завершается ошибкой, возвращается один из следующих кодов ошибок.

Код возврата Описание
E_ACCESSDENIED
 Операция была прервана из-за проблем с разрешениями.
E_INVALIDARG
 Сбой метода, так как параметр был недопустимым.
E_UNEXPECTED
 Сбой метода, так как объект уже находится в коллекции.
 

VB

Если метод завершается успешно, возвращается значение S_OK.

Если метод завершается ошибкой, возвращается один из следующих кодов ошибок.

Код возврата Описание
E_ACCESSDENIED
 Операция была прервана из-за проблем с разрешениями.
E_INVALIDARG
 Сбой метода, так как параметр был недопустимым.
E_UNEXPECTED
 Сбой метода, так как объект уже находится в коллекции.

Комментарии

Если правило с тем же идентификатором правила, что и отправленное, уже существует, существующее правило перезаписывается.

Добавление правила брандмауэра с указанным значением LocalAppPackageId может привести к непредвиденному поведению и не поддерживается.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header netfw.h
DLL FirewallAPI.dll

См. также раздел

INetFwRule

INetFwRules