通过

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 服务强化规则集合可以包含规则，这些规则可以根据特定要求允许此服务特定的入站或出站网络访问。 如果) VARIANT_FALSE ( false，则服务不受 Windows 服务强化的限制。

[in] serviceSidRestricted

指示指定服务的服务 SID 的类型。 如果此值 (VARIANT_TRUE) 为 true，则服务 SID 将受到限制。 否则，它将不受限制。

返回值

C++

如果方法成功，则返回值为S_OK。

如果方法失败，则返回值为以下错误代码之一。

返回代码 说明
E_ACCESSDENIED
 由于权限问题，操作已中止。
E_INVALIDARG
 方法由于参数无效而失败。
 

VB

如果方法成功，则返回值为S_OK。

如果方法失败，则返回值为以下错误代码之一。

返回代码 说明
E_ACCESSDENIED
 由于权限问题，操作已中止。
E_INVALIDARG
 方法由于参数无效而失败。

注解

添加规则时，请注意，应用新添加的规则之前可能存在一小段时间的延迟。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netfw.h
DLL FirewallAPI.dll

另请参阅

INetFwServiceRestriction