Partager via


FWPM_FILTER_ENUM_TEMPLATE0 (Compact 2013)

3/26/2014

This structure is used for enumerating filters.

Syntax

typedef struct FWPM_FILTER_ENUM_TEMPLATE0_ {
  GUID* providerKey;
  GUID layerKey;
  FWP_FILTER_ENUM_TYPE enumType;
  UINT32 flags;
  FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0* providerContextTemplate;
  UINT32 numFilterConditions;
  FWPM_FILTER_CONDITION0* filterCondition;
  UINT32 actionMask;
  GUID* calloutKey;
} FWPM_FILTER_ENUM_TEMPLATE0;

Members

  • providerKey
    Uniquely identifies the provider associated with this filter.
  • layerKey
    Layer whose fields are to be enumerated.
  • flags
    The possible values are listed in the Remarks section below.
  • providerContextTemplate
    A FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 structure that is used to limit the number of filters enumerated. If non-NULL, only enumerate filters whose provider context matches the template.
  • numFilterConditions
    Number of filter conditions. If zero, then all filters match.
  • filterCondition
    An array of FWPM_FILTER_CONDITION0 structures that contain distinct filter conditions (duplicated filter conditions will generate an error).
  • actionMask
    Only filters whose action type contains at least one of the bits in actionMask will be returned.

    Possible values are listed in the Remarks section below.

  • calloutKey
    Uniquely identifies the callout.

Remarks

The following is a list of the possible values for the flags data member.

Value

Meaning

FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCH

Only return the terminating filter with the highest weight.

FWP_FILTER_ENUM_FLAG_SORTED

Return all matching filters sorted by weight (highest to lowest).

FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY

Return only boot-time filters.

FWP_FILTER_ENUM_FLAG_INCLUDE_BOOTTIME

Include boot-time filters; ignored if the FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY flag is set.

FWP_FILTER_ENUM_FLAG_INCLUDE_DISABLED

Include disabled filters; ignored if the FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY flag is set.

The following is a list of the possible values for the actionMask data member:

Value

Meaning

0xFFFFFFFF

Ignore the filter's action type when enumerating.

FWP_ACTION_FLAG_CALLOUT

Enumerate callouts only.

Gg158879.note(en-us,WinEmbedded.80).gifNote:
calloutKey must not be NULL.

Requirements

Header

fwpmu.h

See Also

Reference

WFP Management Structures

Other Resources

Windows Filtering Platform