Condividi tramite

Funzione FwpmProviderContextEnum3 (fwpmk.h)

  • Articolo

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

Sintassi

NTSTATUS FwpmProviderContextEnum3(
  [in]  HANDLE                 engineHandle,
  [in]  HANDLE                 enumHandle,
  [in]  UINT32                 numEntriesRequested,
  [out] FWPM_PROVIDER_CONTEXT3 ***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 contesto del provider creata da una chiamata a FwpmProviderContextCreateEnumHandle0.

[in] numEntriesRequested

Numero di oggetti contesto del provider richiesti.

[out] entries

Oggetti contesto del provider restituiti.

[out] numEntriesReturned

Numero di oggetti contesto del provider restituiti.

Valore restituito

Codice/valore restituito Descrizione
ERROR_SUCCESS
0		 I contesti del 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 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.

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

FwpmProviderContextEnum3 è un'implementazione specifica di FwpmProviderContextEnum. 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