Export (0) Print
Expand All

INetFwPolicy2::IsRuleGroupEnabled method

The IsRuleGroupEnabled method determines whether a specified group of firewall rules are enabled or disabled.

Syntax


HRESULT IsRuleGroupEnabled(
  [in]   long profileTypesBitmask,
  [in]   BSTR group,
  [out]  VARIANT_BOOL *enabled
);

Parameters

profileTypesBitmask [in]

A bitmask of profiles from NET_FW_PROFILE_TYPE2.

group [in]

A string that was used to group rules together. It can be the group name or an indirect string to the group name in the form of "@yourresourcedll.dll,-23255". Rules belonging to this group would be queried.

enabled [out]

Indicates whether the group of rules identified by the group parameter are enabled or disabled.

If this value is set to true (VARIANT_TRUE), the group of rules is enabled; otherwise the group is disabled.

Return value

C++

If the method succeeds, the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Return codeDescription
ACCESSDENIED

The operation was aborted due to permissions issues.

E_INVALIDARG

The method failed due to an invalid parameter.

E_POINTER

The method failed because a pointer was invalid.

S_FALSE

The requested group does not exist.

 

VB

This call returns a boolean enable status which indicates whether the group of rules identified by the group parameter are enabled or disabled. If this value is set to true (VARIANT_TRUE), the group of rules is enabled; otherwise, the group is disabled.

Remarks

When indirect strings in the form of "@yourresourcedll.dll,-23255" are passed as parameters to the Windows Firewall with Advanced Security APIs, they should either be placed under the System32 Windows directory or specified by a full path. Further the file should have a secure access that permits the Local Service account read access to allow the Windows Firewall Service to read the strings. To avoid non-privileged security principals from modifying the strings, the DLLs should only allow write access to the Administrator account.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Netfw.h

DLL

FirewallAPI.dll

See also

INetFwPolicy2

 

 

Build date: 11/16/2013

Community Additions

ADD
Show:
© 2014 Microsoft