Funzione IPsecSaEnum1 (fwpmu.h)

Articolo
03/14/2023

La funzione IPsecSaEnum1 restituisce la pagina successiva dei risultati dell'enumeratore IPsec Security Association (SA).

NotaIPsecSaEnum1 è l'implementazione specifica di IPsecSaEnum usata in Windows 7 e versioni successive. 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. Per Windows Vista è disponibile IPsecSaEnum0 .

Sintassi

DWORD IPsecSaEnum1(
  [in]  HANDLE            engineHandle,
  [in]  HANDLE            enumHandle,
  [in]  UINT32            numEntriesRequested,
  [out] IPSEC_SA_DETAILS1 ***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 SA IPsec. Chiamare IPsecSaCreateEnumHandle0 per ottenere un handle di enumerazione.

[in] numEntriesRequested

Tipo: UINT32

Numero di voci di enumerazione richieste.

[out] entries

Tipo: IPSEC_SA_DETAILS1***

Indirizzi delle voci di enumerazione.

[out] numEntriesReturned

Tipo: UINT32*

Numero di voci di enumerazione restituite.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Gli account del servizio gestito 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 del WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.

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.

IPsecSaEnum1 funziona su uno snapshot delle applicazioni gestite acquisite al momento della creazione dell'handle di enumerazione.

Requisiti


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

IPSEC_SA_DETAILS1

IPsecSaCreateEnumHandle0

Condividi tramite