Funzione FwpmProviderContextEnum1 (fwpmu.h)

Articolo
02/28/2024

La funzione FwpmProviderContextEnum1 restituisce la pagina successiva dei risultati dall'enumeratore del contesto del provider.

NotaFwpmProviderContextEnum1 è l'implementazione specifica di FwpmProviderContextEnum usata in Windows 7. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows . Per Windows 8, fwpmProviderContextEnum2 è disponibile. Per Windows Vista, FwpmProviderContextEnum0 è disponibile.

Sintassi

DWORD FwpmProviderContextEnum1(
  [in]  HANDLE                 engineHandle,
  [in]  HANDLE                 enumHandle,
  [in]  UINT32                 numEntriesRequested,
  [out] FWPM_PROVIDER_CONTEXT1 ***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 FwpmProviderContextCreateEnumHandle0.

[in] numEntriesRequested

Tipo: UINT32

Numero di oggetti contesto del provider richiesti.

[out] entries

Tipo: FWPM_PROVIDER_CONTEXT1***

Oggetti di contesto del provider restituiti.

[out] numEntriesReturned

Tipo: UINT32*

Numero di oggetti contesto del provider restituiti.

Valore restituito

Tipo: DWORD

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

Commenti

Se l'enumEntriesReturned è 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.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

FWPM_PROVIDER_CONTEXT1

FwpmProviderContextCreateEnumHandle0

Condividi tramite