Funzione FwpmSessionEnum0 (fwpmu.h)

La funzione FwpmSessionEnum0 restituisce la pagina successiva dei risultati dell'enumeratore di sessione.

Sintassi

DWORD FwpmSessionEnum0(
  [in]  HANDLE        engineHandle,
  [in]  HANDLE        enumHandle,
  [in]  UINT32        numEntriesRequested,
  [out] FWPM_SESSION0 ***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 di sessione creata da una chiamata a FwpmSessionCreateEnumHandle0.

[in] numEntriesRequested

Tipo: UINT32

Numero di voci di sessione richieste.

[out] entries

Tipo: FWPM_SESSION0***

Indirizzi delle voci di enumerazione.

[out] numEntriesReturned

Tipo: UINT32*

Numero di oggetti sessione restituiti.

Valore restituito

Tipo: DWORD

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.

FwpmSessionEnum0 funziona su uno snapshot delle sessioni eseguite al momento della creazione dell'handle di enumerazione.

FwpmSessionEnum0 è un'implementazione specifica di FwpmSessionEnum. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Requisiti

Vedi anche

FWPM_SESSION0

FwpmSessionCreateEnumHandle0