共用方式為

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

指出指定服務的服務 SID 類型。 如果此值為 true (VARIANT_TRUE) ，服務 SID 將會受到限制。 否則，將會不受限制。

傳回值

C++

如果方法成功，傳回值會S_OK。

如果方法失敗，傳回值就是下列其中一個錯誤碼。

傳回碼 Description
E_ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法因為參數無效而失敗。
 

VB

如果方法成功，傳回值會S_OK。

如果方法失敗，傳回值就是下列其中一個錯誤碼。

傳回碼 Description
E_ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法因為參數無效而失敗。

備註

新增規則時，請注意，在套用新加入的規則之前，可能會有一小段時間延遲。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 netfw.h
Dll FirewallAPI.dll

另請參閱

INetFwServiceRestriction