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。

メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード	説明
E_ACCESSDENIED	アクセス許可の問題が原因で操作が中止されました。
E_INVALIDARG	無効なパラメーターが原因でメソッドが失敗しました。

 

VB

メソッドが成功した場合、戻り値はS_OK。

メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード	説明
E_ACCESSDENIED	アクセス許可の問題が原因で操作が中止されました。
E_INVALIDARG	無効なパラメーターが原因でメソッドが失敗しました。

注釈

ルールを追加する場合は、新しく追加されたルールが適用される前に、タイム ラグが少ない可能性があることに注意してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	netfw.h
[DLL]	FirewallAPI.dll

こちらもご覧ください

INetFwServiceRestriction