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

Метод INetFwServiceRestriction::RestrictService (netfw.h)

  • Статья

Метод RestrictService включает или отключает ограничение службы для данной службы.

Синтаксис

HRESULT RestrictService(
  [in] BSTR         serviceName,
  [in] BSTR         appName,
  [in] VARIANT_BOOL restrictService,
  [in] VARIANT_BOOL serviceSidRestricted
);

Параметры

[in] serviceName

Имя службы, для которой включено или отключено ограничение службы.

[in] appName

Имя приложения, для которого включено или отключено ограничение службы.

[in] restrictService

Указывает, включается или отключается ограничение службы. Если это значение равно true (VARIANT_TRUE), служба будет ограничена при отправке или получении сетевого трафика. Коллекция правил усиления защиты служб Windows может содержать правила, которые могут разрешать входящий или исходящий сетевой доступ для конкретной службы в соответствии с определенными требованиями. Если значение равно false (VARIANT_FALSE), служба не ограничивается усилением защиты служб Windows.

[in] serviceSidRestricted

Указывает тип идентификатора безопасности службы для указанной службы. Если это значение равно true (VARIANT_TRUE), идентификатор безопасности службы будет ограничен. В противном случае она будет неограниченной.

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

C++

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

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

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

VB

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

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

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

Комментарии

При добавлении правил обратите внимание, что перед применением добавленного правила может потребоваться небольшая задержка.

Требования

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

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

INetFwServiceRestriction