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。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
リターン コード | 説明 |
---|---|
|
アクセス許可の問題が原因で操作が中止されました。 |
|
無効なパラメーターが原因でメソッドが失敗しました。 |
VB
メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
リターン コード | 説明 |
---|---|
|
アクセス許可の問題が原因で操作が中止されました。 |
|
無効なパラメーターが原因でメソッドが失敗しました。 |
注釈
ルールを追加する場合は、新しく追加されたルールが適用される前に、タイム ラグが少ない可能性があることに注意してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | netfw.h |
[DLL] | FirewallAPI.dll |