FWPM_PROVIDER_CONTEXT2-Struktur (fwpmtypes.h)

Die FWPM_PROVIDER_CONTEXT2-Struktur speichert den Zustand, der einem Anbieterkontext zugeordnet ist. FWPM_PROVIDER_CONTEXT0 ist verfügbar.

Syntax

typedef struct FWPM_PROVIDER_CONTEXT2_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY1    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *authipQmTunnelPolicy;
    IKEEXT_POLICY2          *ikeMmPolicy;
    IKEEXT_POLICY2          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY2    *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT2;

Member

providerContextKey

Typ: GUID

Identifiziert den Anbieterkontext eindeutig. Wenn die GUID beim Aufruf von FwpmProviderContextAdd2 null initialisiert ist, generiert die Basisfilterungs-Engine (BFE) eine.

displayData

Typ: FWPM_DISPLAY_DATA0

Ermöglicht das Kommentieren von Anbieterkontexten in einer lesbaren Form. Die FWPM_DISPLAY_DATA0-Struktur ist erforderlich.

flags

Typ: UINT32

Mögliche Werte:

Anbieterkontextflag Bedeutung
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT Das Objekt ist persistent, d. h., es bleibt über bfe stop/start erhalten.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL Für die interne Verwendung reserviert.

providerKey

Typ: GUID*

GUID des Richtlinienanbieters, der dieses Objekt verwaltet.

providerData

Typ: FWP_BYTE_BLOB

Optionale anbieterspezifische Daten, mit denen Anbieter zusätzliche Kontextinformationen mit dem -Objekt speichern können.

type

Typ: FWPM_PROVIDER_CONTEXT_TYPE

Der Typ des Anbieterkontexts.

keyingPolicy

Typ: IPSEC_KEYING_POLICY1*

Verfügbar, wenn der TypFWPM_IPSEC_KEYING_CONTEXT ist.

ikeQmTransportPolicy

Typ: IPSEC_TRANSPORT_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT ist.

ikeQmTunnelPolicy

Typ: IPSEC_TUNNEL_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT ist.

authipQmTransportPolicy

Typ: IPSEC_TRANSPORT_POLICY2*

[case()] [eindeutig]

authipQmTunnelPolicy

Typ: IPSEC_TUNNEL_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT ist.

ikeMmPolicy

Typ: IKEEXT_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_IKE_MM_CONTEXT ist.

authIpMmPolicy

Typ: IKEEXT_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_MM_CONTEXT ist.

dataBuffer

Typ: FWP_BYTE_BLOB*

Verfügbar, wenn der TypFWPM_GENERAL_CONTEXT ist.

classifyOptions

Typ: FWPM_CLASSIFY_OPTIONS0*

Verfügbar, wenn der TypFWPM_CLASSIFY_OPTIONS_CONTEXT ist.

ikeV2QmTunnelPolicy

Typ: IPSEC_TUNNEL_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT ist.

ikeV2QmTransportPolicy

Typ: IPSEC_TRANSPORT_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT ist.

ikeV2MmPolicy

Typ: IKEEXT_POLICY2*

Verfügbar, wenn der TypFWPM_IPSEC_IKEV2_MM_CONTEXT ist.

idpOptions

Typ: IPSEC_DOSP_OPTIONS0*

Verfügbar, wenn der TypFWPM_IPSEC_DOSP_CONTEXT ist.

providerContextId

Typ: UINT64

LUID, die den Kontext identifiziert. Dies ist der Kontextwert, der in der FWPS_FILTER1-Struktur für Filter gespeichert ist, die auf einen Anbieterkontext verweisen. Die FWPS_FILTER1-Struktur ist im WDK dokumentiert.

Hinweise

Die ersten sieben Elemente der Union sind Informationen, die beim Hinzufügen von Objekten bereitgestellt werden.

Das letzte Element sind zusätzliche Informationen, die beim Abrufen/Aufzählen von Objekten zurückgegeben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Kopfzeile fwpmtypes.h

Weitere Informationen

FWPM_DISPLAY_DATA0

FWPM_PROVIDER_CONTEXT_TYPE

FWP_BYTE_BLOB

FwpmProviderContextAdd2

IKEEXT_POLICY2

IPSEC_DOSP_OPTIONS0

IPSEC_KEYING_POLICY0

IPSEC_TRANSPORT_POLICY2

IPSEC_TUNNEL_POLICY2

API-Strukturen der Windows-Filterplattform