Funzione FwpmNetEventEnum1 (fwpmu.h)

Articolo
06/27/2024

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

NotaFwpmNetEventEnum1 è l'implementazione specifica di FwpmNetEventEnum usata in Windows 7 e versioni successive. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows. Per Windows 8 è disponibile FwpmNetEventEnum2. Per Windows Vista è disponibile FwpmNetEventEnum0.

Sintassi

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

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] enumHandle

Tipo: HANDLE

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

[in] numEntriesRequested

Tipo: UINT32

Numero di voci di enumerazione richieste.

[out] entries

Tipo: FWPM_NET_EVENT1***

Indirizzi delle voci di enumerazione.

[out] numEntriesReturned

Tipo: UINT32*

Numero di voci di enumerazione restituite.

Valore restituito

Tipo: DWORD

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.

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 restituirà il set successivo di eventi che seguono quelli nella voci corrente buffer.

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7 [solo app desktop]
server minimo supportato	Windows Server 2008 R2 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	fwpmu.h
libreria	Fwpuclnt.lib
dll	Fwpuclnt.dll

Vedere anche

FWPM_NET_EVENT1

FwpmNetEventCreateEnumHandle0

registrazione WFP

Condividi tramite