FWPM_PROVIDER_CONTEXT0-Struktur (fwpmtypes.h)

Artikel
08/23/2023

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

Syntax

typedef struct FWPM_PROVIDER_CONTEXT0_ {
  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_POLICY0 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY0    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY0 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY0    *authipQmTunnelPolicy;
    IKEEXT_POLICY0          *ikeMmPolicy;
    IKEEXT_POLICY0          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT0;

Member

providerContextKey

Identifiziert den Anbieterkontext eindeutig. Wenn die GUID beim Aufruf von FwpmProviderContextAdd0 null initialisiert ist, generiert die Basisfilterungs-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 bleibt über bfe stop/start erhalten.

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_POLICY0 .

ikeQmTunnelPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TUNNEL_POLICY0 .

authipQmTransportPolicy

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TRANSPORT_POLICY0 .

authipQmTunnelPolicy

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT ist.

Weitere Informationen finden Sie unter IPSEC_TUNNEL_POLICY0 .

ikeMmPolicy

Verfügbar, wenn der TypFWPM_IPSEC_IKE_MM_CONTEXT ist.

Weitere Informationen finden Sie unter IKEEXT_POLICY0 .

authIpMmPolicy

Verfügbar, wenn der TypFWPM_IPSEC_AUTHIP_MM_CONTEXT ist.

Weitere Informationen finden Sie unter IKEEXT_POLICY0 .

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 .

providerContextId

LUID, die den Kontext identifiziert. Dies ist der Kontextwert, der in der FWPS_FILTER0-Struktur für Filter gespeichert ist, die auf einen Anbieterkontext verweisen. Die FWPS_FILTER0-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


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	fwpmtypes.h

Weitere Informationen

API-Strukturen der Windows-Filterplattform

Share via