struktur FWPM_PROVIDER_CONTEXT2 (fwpmtypes.h)

Artikel
02/26/2024

Struktur FWPM_PROVIDER_CONTEXT2 menyimpan status yang terkait dengan konteks penyedia. FWPM_PROVIDER_CONTEXT0 tersedia.

Sintaks

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;

Anggota

providerContextKey

Jenis: GUID

Mengidentifikasi konteks penyedia secara unik. Jika GUID diinisialisasi nol dalam panggilan ke FwpmProviderContextAdd2, maka Mesin Pemfilteran Dasar (BFE) akan menghasilkannya.

displayData

Jenis: FWPM_DISPLAY_DATA0

Memungkinkan konteks penyedia diannotasikan dalam bentuk yang dapat dibaca manusia. Struktur FWPM_DISPLAY_DATA0 diperlukan.

flags

Jenis: UINT32

Nilai yang memungkinkan:

Bendera konteks penyedia	Makna
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	Objek ini persisten, yaitu, bertahan di seluruh stop/start BFE.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL	Dicadangkan untuk penggunaan internal.

providerKey

Jenis: GUID*

GUID penyedia kebijakan yang mengelola objek ini.

providerData

Jenis: FWP_BYTE_BLOB

Data khusus penyedia opsional yang memungkinkan penyedia untuk menyimpan info konteks tambahan dengan objek .

type

Jenis: FWPM_PROVIDER_CONTEXT_TYPE

Jenis konteks penyedia.

keyingPolicy

Jenis: IPSEC_KEYING_POLICY1*

Tersedia saat jenisFWPM_IPSEC_KEYING_CONTEXT.

ikeQmTransportPolicy

Jenis: IPSEC_TRANSPORT_POLICY2*

Tersedia saat jenisFWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT.

ikeQmTunnelPolicy

Jenis: IPSEC_TUNNEL_POLICY2*

Tersedia saat jenisFWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT.

authipQmTransportPolicy

Jenis: IPSEC_TRANSPORT_POLICY2*

[case()] [unik]

authipQmTunnelPolicy

Jenis: IPSEC_TUNNEL_POLICY2*

Tersedia saat jenisFWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

ikeMmPolicy

Jenis: IKEEXT_POLICY2*

Tersedia saat jenisFWPM_IPSEC_IKE_MM_CONTEXT.

authIpMmPolicy

Jenis: IKEEXT_POLICY2*

Tersedia saat jenisFWPM_IPSEC_AUTHIP_MM_CONTEXT.

dataBuffer

Jenis: FWP_BYTE_BLOB*

Tersedia saat jenisFWPM_GENERAL_CONTEXT.

classifyOptions

Jenis: FWPM_CLASSIFY_OPTIONS0*

Tersedia saat jenisFWPM_CLASSIFY_OPTIONS_CONTEXT.

ikeV2QmTunnelPolicy

Jenis: IPSEC_TUNNEL_POLICY2*

Tersedia saat jenisFWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT.

ikeV2QmTransportPolicy

Jenis: IPSEC_TRANSPORT_POLICY2*

Tersedia saat jenisFWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT.

ikeV2MmPolicy

Jenis: IKEEXT_POLICY2*

Tersedia saat jenisFWPM_IPSEC_IKEV2_MM_CONTEXT.

idpOptions

Jenis: IPSEC_DOSP_OPTIONS0*

Tersedia saat jenisFWPM_IPSEC_DOSP_CONTEXT.

providerContextId

Jenis: UINT64

LUID mengidentifikasi konteks. Ini adalah nilai konteks yang disimpan dalam struktur FWPS_FILTER1 untuk filter yang mereferensikan konteks penyedia. Struktur FWPS_FILTER1 di dokumentasikan dalam WDK.

Keterangan

Tujuh elemen pertama dari serikat adalah informasi yang disediakan saat menambahkan objek.

Elemen terakhir adalah informasi tambahan yang dikembalikan saat mendapatkan/menghitung objek.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	fwpmtypes.h