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

Метод INetFwPolicy2::get_IsRuleGroupCurrentlyEnabled (netfw.h)

  • Статья

Метод get_IsRuleGroupCurrentlyEnabled определяет, включена или отключена указанная группа правил брандмауэра для текущего профиля.

Синтаксис

HRESULT get_IsRuleGroupCurrentlyEnabled(
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

Параметры

[in] group

Строка, которая использовалась для группировки правил. Это может быть имя группы или непрямая строка для имени группы в виде "@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234". Будут запрашиваться правила, входящие в эту группу.

[out] enabled

Указывает, включена или отключена группа правил, определяемая параметром group .

Если для этого значения задано значение true (VARIANT_TRUE), группа правил включена; в противном случае группа отключена.

Для Windows 7 и более поздних версий это значение будет иметь значение true (VARIANT_TRUE), если группа правил включена по крайней мере в одном активном профиле.

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

C++

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

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

Код возврата Описание
ACCESSDENIED
 Операция была прервана из-за проблем с разрешениями.
E_INVALIDARG
 Сбой метода из-за недопустимого параметра.
E_POINTER
 Сбой метода из-за недопустимого указателя.
 

Для Windows 7 и более поздних версий, если несколько профилей активны и профили имеют разные ответы для IsRuleGroupCurrentlyEnabled, возвращаемое значение будет S_FALSE; Если профили имеют одинаковый ответ для IsRuleGroupCurrentlyEnabled, возвращаемое значение будет S_TRUE.

VB

Этот вызов возвращает логическое состояние включения, которое указывает, включена или отключена группа правил, определяемая параметром group. Если для этого значения задано значение true (VARIANT_TRUE), группа правил включена; в противном случае группа будет отключена.

Комментарии

Если косвенные строки в виде "@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" передаются в качестве параметров в API брандмауэра Windows в режиме повышенной безопасности, они должны быть указаны полным путем. Файл должен иметь безопасный доступ, который разрешает учетной записи локальной службы доступ на чтение, чтобы служба брандмауэра Windows считывала строки. Чтобы избежать изменения строк непривилегированных субъектов безопасности, библиотеки DLL должны разрешать доступ на запись только к учетной записи администратора.

Требования

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

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

INetFwPolicy2

Создание правил