Funzione FwpmEngineSetOption0 (fwpmu.h)

Articolo
08/23/2023

La funzione FwpmEngineSetOption0 modifica le impostazioni del motore di filtro.

Sintassi

DWORD FwpmEngineSetOption0(
  [in] HANDLE             engineHandle,
  [in] FWPM_ENGINE_OPTION option,
  [in] const FWP_VALUE0   *newValue
);

Parametri

[in] engineHandle

Tipo: HANDLE

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] option

Tipo: FWPM_ENGINE_OPTION

Opzione da impostare.

[in] newValue

Tipo: FWP_VALUE0*

Nuovo valore di opzione. Il tipo di dati contenuto nel parametro newValue deve essere FWP_UINT32.

Quando l'opzione è FWPM_ENGINE_COLLECT_NET_EVENTS, newValue deve essere una delle seguenti.

Valore	Significato
0	Non raccogliere eventi di rete.
1	Raccogliere eventi di rete. Si tratta dell'impostazione predefinita.

Quando l'opzione è FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS, newValue deve essere 0 (zero) o una combinazione bit per bit dei valori seguenti.

Nota Se newValue è 0 la raccolta di eventi multicast in ingresso e broadcast è disabilitata. Si tratta dell'impostazione predefinita.

Valore	Significato
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST 1	Raccogliere eventi di rete multicast in ingresso.
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST 2	Raccogliere eventi di rete di trasmissione in ingresso.

Quando l'opzioneè FWPM_ENGINE_PACKET_QUEUING (disponibile solo in Windows 8 e Windows Server 2012), newValue deve essere uno dei seguenti.

Valore	Significato
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE 0	Non abilitare l'accodamento dei pacchetti.
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND 1	Abilitare l'accodamento dei pacchetti in ingresso.
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND 2	Abilitare l'accodamento dei pacchetti in uscita.

Quando l'opzioneè FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS (disponibile solo in Windows 8 e Windows Server 2012), newValue deve essere il seguente. (FwpmEngineSetOption0 può essere usato per abilitare le connessioni, ma avrà esito negativo FWP_E_STILL_ON ERRORE quando si tenta di disabilitarlo.

Valore	Significato
1	La funzionalità di monitoraggio connessione IPsec sarà abilitata. Verranno registrati nuovi eventi di connessione IPsec e notifiche inviate.

Quando l'opzioneè FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC (disponibile solo in Windows 8 e Windows Server 2012), newValue deve essere il tempo in millisecondi che specifica la durata massima per una singola transazione WFP. Le transazioni che richiedono più tempo di questa durata attiveranno un evento watchdog.

L'opzione FWPM_ENGINE_NAME_CACHE è riservata per l'uso interno.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'opzione è stata impostata correttamente.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

Questa funzione non può essere chiamata dall'interno di una transazione. Avrà esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedere Gestione oggetti .

Questa funzione non può essere chiamata dall'interno di una sessione dinamica. Avrà esito negativo con FWP_E_DYNAMIC_SESSION_IN_PROGRESS. Per altre informazioni sulle sessioni, vedere Gestione oggetti .

Il chiamante deve FWPM_ACTRL_WRITE l'accesso al motore di filtro. Per altre informazioni, vedere Controllo di accesso.

Le impostazioni predefinite per la raccolta eventi di rete sono le seguenti:

Vengono raccolti tutti gli eventi in uscita (unicast, multicast e broadcast).
In ingresso vengono raccolti solo eventi unicast.

Le impostazioni della raccolta eventi di rete vengono mantenute tra i riavvii.

Per raccogliere eventi di rete in ingresso e/o multicast,

Chiamare FwpmEngineSetOption0 con l'opzione impostata su FWPM_ENGINE_COLLECT_NET_EVENTS e newValue impostata su 1.
Chiamare FwpmEngineSetOption0 con l'opzione impostata su FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS e il parametro newValue impostato su FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST e/o FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST.

Per interrompere la raccolta di eventi di rete in ingresso e/o multicast,

Chiamare FwpmEngineSetOption0 con l'opzione impostata su FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS e il parametro newValue impostato su 0 (zero).

La disabilitazione e la riattivazione della raccolta eventi di rete (FWPM_ENGINE_COLLECT_NET_EVENTS) non reimposta la raccolta di eventi in ingresso e multicast.

FwpmEngineSetOption0 è un'implementazione specifica di FwpmEngineSetOption. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

FWPM_ENGINE_OPTION

FWP_VALUE0

FwpmEngineGetOption0

Condividi tramite