Funzione FwpmNetEventEnum0 (fwpmu.h)

  • Articolo

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

NotaFwpmNetEventEnum0 è l'implementazione specifica di FwpmNetEventEnum usata in Windows Vista. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. Per Windows 7, FwpmNetEventEnum1 è disponibile. Per Windows 8, è disponibile FwpmNetEventEnum2.
 

Sintassi

DWORD FwpmNetEventEnum0(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT0 ***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_EVENT0***

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 del WFP .
RPC_* codice di errore
0x80010001: 0x80010122
 Errore di comunicazione con il motore firewall remoto o locale.

Commenti

Se numEntriesReturned è minore di 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 usa lo stesso parametro enumHandle restituirà il set successivo di eventi che seguono quelli nel buffer delle voci correnti.

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

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione fwpmu.h
Libreria Fwpuclnt.lib
DLL Fwpuclnt.dll

Vedi anche

FWPM_NET_EVENT0

FwpmNetEventCreateEnumHandle0

Registrazione DEL WFP