FWPM_PROVIDER_CONTEXT1-Struktur (fwpmtypes.h)

Artikel
08/23/2023

Die FWPM_PROVIDER_CONTEXT1-Struktur speichert den Zustand, der einem Anbieterkontext zugeordnet ist. FWPM_PROVIDER_CONTEXT2 ist verfügbar. Für Windows Vista ist FWPM_PROVIDER_CONTEXT0 verfügbar.

Syntax

typedef struct FWPM_PROVIDER_CONTEXT1_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY0    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY1 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY1 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *authipQmTunnelPolicy;
    IKEEXT_POLICY1          *ikeMmPolicy;
    IKEEXT_POLICY1          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY1    *ikeV2QmTunnelPolicy;
    IKEEXT_POLICY1          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT1;

Member

providerContextKey

Identifiziert eindeutig den Anbieterkontext. Wenn die GUID im Aufruf von FwpmProviderContextAdd1 null initialisiert ist, generiert die Basisfilter-Engine (BFE) eine.

displayData

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

flags

Mögliche Werte:

Anbieterkontextflag	Bedeutung
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	Das Objekt ist persistent, d. h. es überlebt über BFE-Stopp/-Start.

providerKey

GUID des Richtlinienanbieters, der dieses Objekt verwaltet.

providerData

Eine FWP_BYTE_BLOB-Struktur , die optionale anbieterspezifische Daten enthält, mit denen Anbieter zusätzliche Kontextinformationen mit dem -Objekt speichern können.

type

Ein FWPM_PROVIDER_CONTEXT_TYPE Wert, der den Typ des Anbieterkontexts angibt.

keyingPolicy

Verfügbar, wenn der TypFWPM_IPSEC_KEYING_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_KEYING_POLICY0 .

ikeQmTransportPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TRANSPORT_POLICY1 .

ikeQmTunnelPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TUNNEL_POLICY1 .

authipQmTransportPolicy

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TRANSPORT_POLICY1 .

authipQmTunnelPolicy

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TUNNEL_POLICY1 .

ikeMmPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKE_MM_CONTEXT ist.

Weitere Informationen finden Sie unter IKEEXT_POLICY1 .

authIpMmPolicy

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_MM_CONTEXT ist.

Weitere Informationen finden Sie unter IKEEXT_POLICY1 .

dataBuffer

Verfügbar, wenn der TypFWPM_GENERAL_CONTEXT ist.

Weitere Informationen finden Sie unter FWP_BYTE_BLOB .

classifyOptions

Verfügbar, wenn der TypFWPM_CLASSIFY_OPTIONS_CONTEXT ist.

Weitere Informationen finden Sie unter FWPM_CLASSIFY_OPTIONS0 .

ikeV2QmTunnelPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TUNNEL_POLICY1 .

ikeV2MmPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKEV2_MM_CONTEXT ist.

Weitere Informationen finden Sie unter IKEEXT_POLICY1 .

idpOptions

Verfügbar, wenn der TypFWPM_IPSEC_DOSP_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_DOSP_OPTIONS0 .

providerContextId

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 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	fwpmtypes.h