Funzione FwpmConnectionEnum0 (fwpmu.h)
La funzione FwpmConnectionEnum0 restituisce la pagina successiva dei risultati dell'enumeratore dell'oggetto connessione.
Sintassi
DWORD FwpmConnectionEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_CONNECTION0 ***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 del contesto del provider creata da una chiamata a FwpmConnectionCreateEnumHandle0.
[in] numEntriesRequested
Tipo: UINT32
Numero di oggetti di connessione richiesti.
[out] entries
Tipo: FWPM_CONNECTION0***
Indirizzi delle voci di enumerazione.
[out] numEntriesReturned
Tipo: UINT32*
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
Gli oggetti connessione sono stati enumerati correttamente. |
|
Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore del WFP . |
|
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 handle di enumerazione restituirà il set successivo di elementi che seguono quelli nell'ultimo buffer di output.
FwpmConnectionEnum0 funziona su uno snapshot degli oggetti connessione acquisiti al momento della creazione dell'handle di enumerazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fwpmu.h |
| Libreria | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |