Funzione FwpmNetEventCreateEnumHandle0 (fwpmu.h)
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 |
---|---|
|
L'enumeratore è stato creato correttamente. |
|
Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore WFP . |
|
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 |