Condividi tramite

Funzione FwpmEngineSetOption0 (fwpmk.h)

  • Articolo

La funzione FwpmEngineSetOption0 modifica le impostazioni del motore di filtro.

Sintassi

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

Parametri

[in] engineHandle

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

[in] option

Opzione da impostare.

[in] newValue

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

Quando opzione è FWPM_ENGINE_COLLECT_NET_EVENTS, newValue deve essere uno dei seguenti.

Valore Significato
0 Non raccogliere eventi di rete.
1 Raccogliere gli eventi di rete. Questa è l'impostazione predefinita.

Quando '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. Questa è l'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 broadcast in ingresso.

Quando 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 pacchetti.
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND
1		 Abilitare l'accodamento pacchetti in ingresso.
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND
2		 Abilitare l'accodamento pacchetti in uscita.

Quando '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 con FWP_E_STILL_ON ERRORE quando si tenta di disabilitarlo.

Valore Significato
1 La funzionalità Monitoraggio connessione IPsec verrà abilitata. Verranno registrati nuovi eventi di connessione IPsec e le notifiche inviate.

Quando '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

Codice/valore restituito Descrizione
ERROR_SUCCESS
0		 Successo
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		 Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS Si è verificato un errore.

Osservazioni

Questa funzione non può essere chiamata dall'interno di una transazione, ma ha 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, ma ha esito negativo con FWP_E_DYNAMIC_SESSION_IN_PROGRESS. Per altre informazioni sulle sessioni, vedere Object Management.

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

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

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

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

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

  1. Chiamare FwpmEngineSetOption0 con l'opzione impostata su FWPM_ENGINE_COLLECT_NET_EVENTS e newValue impostata su 1.
  2. Chiamare FwpmEngineSetOption0 con l'opzione impostata su FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS e 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 parametro newValue impostato su 0 (zero).

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

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

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows Vista.
piattaforma di destinazione Universale
intestazione fwpmk.h
libreria fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Vedere anche