Condividi tramite

Funzione FwpmEngineGetOption0 (fwpmk.h)

  • Articolo

La funzione FwpmEngineGetOption0 recupera un'opzione del motore di filtro.

Sintassi

NTSTATUS FwpmEngineGetOption0(
  [in]  HANDLE             engineHandle,
  [in]  FWPM_ENGINE_OPTION option,
  [out] FWP_VALUE0         **value
);

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

[out] value

Valore dell'opzione. Il tipo di dati contenuto nel parametro value verrà FWP_UINT32.

Se l'opzione è FWPM_ENGINE_COLLECT_NET_EVENTS, il valore sarà uno dei seguenti.

Valore Significato
0 Gli eventi di rete non vengono raccolti.
1 Gli eventi di rete vengono raccolti.

Se 'opzione è FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS, valore sarà una combinazione bit per bit dei valori seguenti.

Valore Significato
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST (1) Gli eventi di rete multicast in ingresso vengono raccolti.
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST (2) Gli eventi di rete di trasmissione in ingresso non vengono raccolti.

Se 'opzione è FWPM_ENGINE_PACKET_QUEUING (disponibile solo in Windows 8 e Windows Server 2012), valore sarà uno dei seguenti.

Valore Significato
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE (0) Non è abilitato alcun accodamento pacchetti.
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND (1) Accodamento pacchetti in ingresso è abilitato.
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND (2) L'accodamento pacchetti in uscita è abilitato.

Se opzione è FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS (disponibile solo in Windows 8 e Windows Server 2012), valore sarà uno dei seguenti.

Valore Significato
0 La funzionalità Monitoraggio connessione IPsec è disabilitata. Non vengono registrati eventi o notifiche di connessione IPsec.
1 La funzionalità Monitoraggio connessione IPsec è abilitata. Vengono registrati nuovi eventi e notifiche di connessione IPsec.

Se opzione è FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC (disponibile solo in Windows 8 e Windows Server 2012), valore sarà 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 L'opzione è stata recuperata 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 Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS Si è verificato un errore.

Osservazioni

Il chiamante deve liberare l'oggetto restituito da una chiamata a FwpmFreeMemory0.

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

FwpmEngineGetOption0 è un'implementazione specifica di FwpmEngineGetOption. 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