次の方法で共有

INetFwPolicy2::get_IsRuleGroupCurrentlyEnabled メソッド (netfw.h)

  • [アーティクル]

get_IsRuleGroupCurrentlyEnabledメソッドは、現在のプロファイルに対して、指定したファイアウォール規則のグループが有効か無効かを決定します。

構文

HRESULT get_IsRuleGroupCurrentlyEnabled(
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

パラメーター

[in] group

ルールをグループ化するために使用された文字列。 "@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" の形式でグループ名またはグループ名の間接文字列を指定できます。 このグループに属するルールに対してクエリが実行されます。

[out] enabled

group パラメーターによって識別されるルールのグループが有効か無効かを示します。

この値が true (VARIANT_TRUE) に設定されている場合、ルールのグループが有効になります。それ以外の場合、グループは無効になります。

Windows 7 以降では、少なくとも 1 つのアクティブなプロファイルでルール グループが有効になっている場合、この値は true (VARIANT_TRUE) に設定されます。

戻り値

C++

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

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

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

Windows 7 以降では、複数のプロファイルがアクティブで、プロファイルの IsRuleGroupCurrentlyEnabled に対する回答が異なる場合、戻り値はS_FALSE。プロファイルに IsRuleGroupCurrentlyEnabled に対して同じ回答がある場合、戻り値はS_TRUE。

VB

この呼び出しは、group パラメーターによって識別されるルールのグループが有効か無効かを示すブール型の有効化状態を返します。 この値が true (VARIANT_TRUE) に設定されている場合、ルールのグループが有効になります。それ以外の場合、グループは無効になります。

注釈

"@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" の形式の間接文字列が、Advanced Security API を使用して Windows ファイアウォールにパラメーターとして渡される場合は、完全なパスで指定する必要があります。 ファイルには、Windows ファイアウォール サービスが文字列を読み取ることができるように、ローカル サービス アカウントの読み取りアクセスを許可するセキュリティで保護されたアクセス権が必要です。 特権のないセキュリティ プリンシパルによる文字列の変更を回避するために、DLL では管理者アカウントへの書き込みアクセスのみを許可する必要があります。

要件

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

こちらもご覧ください

INetFwPolicy2

ルールの作成