Funzione FwpmNetEventCreateEnumHandle0 (fwpmu.h)

  • Articolo

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

Sintassi

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

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, optional] enumTemplate

Tipo: FWPM_NET_EVENT_ENUM_TEMPLATE0*

Modello per limitare in modo selettivo l'enumerazione.

[out] enumHandle

Tipo: HANDLE*

Handle per l'enumerazione dell'evento di rete.

Valore restituito

Tipo: DWORD

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

Commenti

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. Avrà 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 Controllo di accesso.

FwpmNetEventCreateEnumHandle0 è un'implementazione specifica di FwpmNetEventCreateEnumHandle . Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

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_EVENT_ENUM_TEMPLATE0

FwpmNetEventDestroyEnumHandle0