Condividi tramite

Funzione FwpmNetEventEnum1 (fwpmk.h)

  • Articolo

La funzione FwpmNetEventEnum1 restituisce la pagina successiva dei risultati dell'enumeratore di eventi di rete.

Sintassi

NTSTATUS FwpmNetEventEnum1(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT1 ***entries,
  [out] UINT32          *numEntriesReturned
);

Parametri

[in] engineHandle

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

[in] enumHandle

Handle per un'enumerazione di eventi di rete creata da una chiamata a FwpmNetEventCreateEnumHandle0.

[in] numEntriesRequested

Numero di voci di enumerazione richieste.

[out] entries

Indirizzi delle voci di enumerazione.

[out] numEntriesReturned

Numero di voci di enumerazione restituite.

Valore restituito

Codice/valore restituito Descrizione
ERROR_SUCCESS
0		 Gli eventi di rete sono stati enumerati correttamente.
FWP_E_NET_EVENTS_DISABLED
0x80320013		 La raccolta di eventi di diagnostica di rete è disabilitata. Chiamare FwpmEngineSetOption0 per abilitarlo.
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 il numEntriesReturned è minore del numEntriesRequested, l'enumerazione viene esaurita.

La matrice restituita di voci (ma non le singole voci) deve essere liberata da una chiamata a FwpmFreeMemory0.

Una chiamata successiva che utilizza lo stesso parametro enumHandle restituisce il set successivo di eventi che seguono quelli nelle voci correnti buffer.

FwpmNetEventEnum1 restituisce solo gli eventi registrati prima della creazione del parametro enumHandle. Per altre informazioni, vedere di registrazione .

FwpmNetEventEnum1 è un'implementazione specifica di FwpmNetEventEnum. 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