Funzione FwpmNetEventEnum4 (fwpmu.h)

Articolo
05/03/2024

Recupera la pagina successiva dei risultati dall'enumeratore eventi di rete.

Sintassi

DWORD FwpmNetEventEnum4(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT4 ***entries,
  UINT32          *numEntriesReturned
);

Parametri

engineHandle

Tipo: _In_ HANDLE

Handle per una sessione aperta con il motore di filtro. Per aprire una sessione con il motore di filtro, chiamare FwpmEngineOpen0.

enumHandle

Tipo: _In_ HANDLE

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

numEntriesRequested

Tipo: _In_ UINT32

Numero di voci di enumerazione richieste.

entries

Tipo: _Outptr_result_buffer_(*numEntriesReturned) const FWPM_NET_EVENT4***

Indirizzi delle voci di enumerazione.

numEntriesReturned

Tipo: _Out_ UINT32*

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	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

Se numEntriesReturned è minore di numEntriesRequested, l'enumerazione viene esaurita.

È necessario liberare la matrice restituita di voci (ma non le singole voci) chiamando FwpmFreeMemory0.

Una chiamata successiva che usa lo stesso parametro enumHandle restituirà il set successivo di eventi che seguono quelli nel buffer delle voci correnti.

FwpmNetEventEnum4 restituisce solo eventi registrati prima della creazione del parametro enumHandle . Per altre informazioni, vedere Registrazione.

Requisiti

Requisito	Valore
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Condividi tramite