Condividi tramite


Funzione FwpmCalloutEnum0 (fwpmu.h)

La funzione FwpmCalloutEnum0 restituisce la pagina successiva dei risultati dell'enumeratore callout.

Sintassi

DWORD FwpmCalloutEnum0(
  [in]  HANDLE        engineHandle,
  [in]  HANDLE        enumHandle,
  [in]  UINT32        numEntriesRequested,
  [out] FWPM_CALLOUT0 ***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 callout creata da una chiamata a FwpmCalloutCreateEnumHandle0.

[in] numEntriesRequested

Tipo: UINT32

Numero di oggetti callout richiesti.

[out] entries

Tipo: FWP_CALLOUT0***

Indirizzi delle voci di enumerazione.

[out] numEntriesReturned

Tipo: UINT32*

Numero di callout restituiti.

Valore restituito

Tipo: DWORD

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

FwpmCalloutEnum0 funziona su uno snapshot dei callout eseguiti al momento della creazione dell'handle di enumerazione.

FwpmCalloutEnum0 è un'implementazione specifica di FwpmCalloutEnum. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Requisiti

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

Vedi anche

FWP_CALLOUT0

FwpmCalloutCreateEnumHandle0