Funzione FwpmProviderEnum0 (fwpmk.h)

Articolo
07/16/2024

La funzione fwpmProviderEnum0 restituisce la pagina successiva dei risultati dell'enumeratore del provider.

Sintassi

NTSTATUS FwpmProviderEnum0(
  [in]  HANDLE         engineHandle,
  [in]  HANDLE         enumHandle,
  [in]  UINT32         numEntriesRequested,
  [out] FWPM_PROVIDER0 ***entries,
  [out] UINT32         *numEntriesReturned
);

Parametri

[in] engineHandle

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] enumHandle

Handle per un'enumerazione del provider creata da una chiamata a FwpmProviderCreateEnumHandle0.

[in] numEntriesRequested

Numero di voci del provider richieste.

[out] entries

Indirizzi delle voci di enumerazione.

[out] numEntriesReturned

Numero di oggetti provider restituiti.

Valore restituito

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	I provider sono stati enumerati 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	Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS	Si è verificato un errore.

Osservazioni

Se il numEntriesReturned è minore del 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.

fwpmProviderEnum0 funziona su uno snapshot dei provider acquisiti al momento della creazione dell'handle di enumerazione.

FwpmProviderEnum0 è un'implementazione specifica di FwpmProviderEnum. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows Vista.
piattaforma di destinazione	Universale
intestazione	fwpmk.h
libreria	fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Vedere anche

Di seguito sono riportati tutti i collegamenti formattati markdown nel documento corrente:

Condividi tramite