Share via

2.2.33 FW_ENUM_RULES_FLAGS

  • Article

This enumeration defines flag values that can be used in the enumeration methods that are defined in RRPC_FWEnumFirewallRules, RRPC_FWEnumConnectionSecurityRules, RRPC_FWEnumAuthenticationSets, and RRPC_FWEnumCryptoSets.

 typedef  enum _tag_FW_ENUM_RULES_FLAGS
 {
   FW_ENUM_RULES_FLAG_NONE = 0x0000,
   FW_ENUM_RULES_FLAG_RESOLVE_NAME = 0x0001,
   FW_ENUM_RULES_FLAG_RESOLVE_DESCRIPTION = 0x0002,
   FW_ENUM_RULES_FLAG_RESOLVE_APPLICATION = 0x0004,
   FW_ENUM_RULES_FLAG_RESOLVE_KEYWORD = 0x0008,
   FW_ENUM_RULES_FLAG_RESOLVE_GPO_NAME = 0x0010,
   FW_ENUM_RULES_FLAG_EFFECTIVE = 0x0020,
   FW_ENUM_RULES_FLAG_INCLUDE_METADATA = 0x0040,
   FW_ENUM_RULES_FLAG_MAX = 0x0080
 } FW_ENUM_RULES_FLAGS;

FW_ENUM_RULES_FLAG_NONE:  This value signifies that no specific flag is used. It is defined for IDL definitions and code to add readability, instead of using the number 0. This symbolic constant has a value 0x0000.

FW_ENUM_RULES_FLAG_RESOLVE_NAME:  Resolves rule description strings to user-friendly, localizable strings if they are in the following format: @file.dll,-<resID>. resID refers to the resource ID in the indirect string. Please see [MSDN-SHLoadIndirectString] for further documentation on the string format. This symbolic constant has a value 0x0001.

FW_ENUM_RULES_FLAG_RESOLVE_DESCRIPTION:  Resolves rule description strings to user-friendly, localizable strings if they are in the following format: @file.dll,-<resID>. resID refers to the resource ID in the indirect string. Please see [MSDN-SHLoadIndirectString] for further documentation on the string format. This symbolic constant has a value 0x0002.

FW_ENUM_RULES_FLAG_RESOLVE_APPLICATION:  If this flag is set, the server MUST inspect the wszLocalApplication field of each FW_RULE structure and replace all environment variables in the string with their corresponding values. See [MSDN-ExpandEnvironmentStrings] for more details about environment-variable strings. This symbolic constant has a value 0x0004.

FW_ENUM_RULES_FLAG_RESOLVE_KEYWORD:  Resolves keywords in addresses and ports to the actual addresses and ports (dynamic store only). This symbolic constant has a value 0x0008.

FW_ENUM_RULES_FLAG_RESOLVE_GPO_NAME:  Resolves the GPO name for the GP_RSOP rules. This symbolic constant has a value 0x0010.

FW_ENUM_RULES_FLAG_EFFECTIVE:  If this flag is set, the server MUST only return objects where at least one FW_ENFORCEMENT_STATE entry in the object's metadata is equal to FW_ENFORCEMENT_STATE_FULL. This flag is available for the dynamic store only. This symbolic constant has a value 0x0020.

FW_ENUM_RULES_FLAG_INCLUDE_METADATA:  Includes the metadata object information, represented by the FW_OBJECT_METADATA structure, in the enumerated objects. This symbolic constant has a value 0x0040.

FW_ENUM_RULES_FLAG_MAX:  This value and values that exceed this value are not valid and MUST NOT be used. It is defined for simplicity in writing IDL definitions and code. This symbolic constant has a value 0x0080.