Condividi tramite

Funzione FwpmNetEventCreateEnumHandle0 (fwpmk.h)

  • Articolo

La funzione FwpmNetEventCreateEnumHandle0 crea un handle usato per enumerare un set di eventi di rete.

Sintassi

NTSTATUS FwpmNetEventCreateEnumHandle0(
  [in]           HANDLE                              engineHandle,
  [in, optional] const FWPM_NET_EVENT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                              *enumHandle
);

Parametri

[in] engineHandle

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

[in, optional] enumTemplate

Modello per limitare in modo selettivo l'enumerazione.

[out] enumHandle

Handle per l'enumerazione degli eventi di rete.

Valore restituito

Codice/valore restituito Descrizione
ERROR_SUCCESS
0		 L'enumeratore è stato creato 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

Se enumTemplate è NULL, vengono restituiti tutti gli oggetti evento di rete.

Il chiamante deve chiamare FwpmNetEventDestroyEnumHandle0 per liberare l'handle restituito.

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 .

Il chiamante deve FWPM_ACTRL_ENUM l'accesso ai contenitori degli eventi. Per altre informazioni, vedere di controllo di accesso.

FwpmNetEventCreateEnumHandle0 è un'implementazione specifica di FwpmNetEventCreateEnumHandle. 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