Edit

FWPM_PROVIDER0 structure (fwpmtypes.h)

  • Article

The FWPM_PROVIDER0 structure stores the state associated with a policy provider.

Syntax

typedef struct FWPM_PROVIDER0_ {
  GUID               providerKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  FWP_BYTE_BLOB      providerData;
  wchar_t            *serviceName;
} FWPM_PROVIDER0;

Members

providerKey

Uniquely identifies the provider.

If the GUID is zero-initialized in the call to Add, Base Filtering Engine (BFE) will generate one.

displayData

Allows providers to be annotated in a human-readable form. The FWPM_DISPLAY_DATA0 structure is required.

flags

Bit flags that indicate information about the persistence of the provider.

Provider flag Meaning
FWPM_PROVIDER_FLAG_PERSISTENT
 Provider is persistent.
FWPM_PROVIDER_FLAG_DISABLED
 Provider's filters were disabled when the BFE started because the provider has no associated Windows service name, or because the associated service was not set to auto-start.
Note  This flag cannot be set when adding new providers. It can only be returned by BFE when getting or enumerating providers.
 

providerData

An FWP_BYTE_BLOB structure that contains optional provider-specific data that allows providers to store additional context info with the object.

serviceName

Optional name of the Windows service hosting the provider. This allows BFE to detect that a provider has been disabled.

Remarks

FWPM_PROVIDER0 is a specific implementation of FWPM_PROVIDER. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header fwpmtypes.h

See also

FWPM_DISPLAY_DATA0

Windows Filtering Platform API Structures