struttura FWPM_PROVIDER_CONTEXT3 (fwpmtypes.h)

Articolo
04/30/2024

Archivia lo stato associato a un contesto del provider. sono disponibili FWPM_PROVIDER_CONTEXT0, FWPM_PROVIDER_CONTEXT1 e FWPM_PROVIDER_CONTEXT2 .

Sintassi

typedef struct FWPM_PROVIDER_CONTEXT3_ {
  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_POLICY3                     *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY3                     *authipQmTunnelPolicy;
    IKEEXT_POLICY2                           *ikeMmPolicy;
    IKEEXT_POLICY2                           *authIpMmPolicy;
    FWP_BYTE_BLOB                            *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0                   *classifyOptions;
    IPSEC_TUNNEL_POLICY3                     *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2                           *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0                      *idpOptions;
    FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 *networkConnectionPolicy;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT3;

Members

providerContextKey

Tipo: GUID

Identifica in modo univoco il contesto del provider. Se il GUID è inizializzato zero nella chiamata a FwpmProviderContextAdd2, il motore di filtro di base ne genererà uno.

displayData

Tipo: FWPM_DISPLAY_DATA0

Consente di annotare i contesti del provider in un formato leggibile. La struttura FWPM_DISPLAY_DATA0 è obbligatoria.

flags

Tipo: UINT32

Valori possibili:

Flag di contesto del provider	Significato
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	L'oggetto è persistente, ovvero sopravvive all'arresto/avvio BFE.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL	Riservato per utilizzo interno.

providerKey

Tipo: GUID*

GUID del provider di criteri che gestisce questo oggetto.

providerData

Tipo: FWP_BYTE_BLOB

Dati facoltativi specifici del provider che consentono ai provider di archiviare informazioni di contesto aggiuntive con l'oggetto .

type

Tipo: FWPM_PROVIDER_CONTEXT_TYPE

Tipo di contesto del provider.

keyingPolicy

Tipo: IPSEC_KEYING_POLICY1*

Disponibile quando il tipo è FWPM_IPSEC_KEYING_CONTEXT.

ikeQmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT.

ikeQmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT.

authipQmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

[case()] [univoco]

authipQmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

ikeMmPolicy

Tipo: IKEEXT_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_IKE_MM_CONTEXT.

authIpMmPolicy

Tipo: IKEEXT_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_AUTHIP_MM_CONTEXT.

dataBuffer

Tipo: FWP_BYTE_BLOB*

Disponibile quando il tipo è FWPM_GENERAL_CONTEXT.

classifyOptions

Tipo: FWPM_CLASSIFY_OPTIONS0*

Disponibile quando il tipo è FWPM_CLASSIFY_OPTIONS_CONTEXT.

ikeV2QmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT.

ikeV2QmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT.

ikeV2MmPolicy

Tipo: IKEEXT_POLICY2*

Disponibile quando il tipo è FWPM_IPSEC_IKEV2_MM_CONTEXT.

idpOptions

Tipo: IPSEC_DOSP_OPTIONS0*

Disponibile quando il tipo è FWPM_IPSEC_DOSP_CONTEXT.

networkConnectionPolicy

Puntatore a una struttura FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 contenente il numero di criteri di connessione di rete e un elenco di tali criteri formattati.

providerContextId

Tipo: UINT64

LUID che identifica il contesto. Si tratta del valore di contesto archiviato nella struttura FWPS_FILTER1 per i filtri che fanno riferimento a un contesto del provider. La struttura FWPS_FILTER1 è documentata in WDK. Si tratta di informazioni aggiuntive restituite durante il recupero/enumerazione di oggetti.