Funzione IPsecSaCreateEnumHandle0 (fwpmu.h)
La funzione IPsecSaCreateEnumHandle0 crea un handle usato per enumerare un set di oggetti dell'associazione di sicurezza IPsec (Internet Protocol Security).
Sintassi
DWORD IPsecSaCreateEnumHandle0(
[in] HANDLE engineHandle,
[in, optional] const IPSEC_SA_ENUM_TEMPLATE0 *enumTemplate,
[out] HANDLE *enumHandle
);
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, optional] enumTemplate
Tipo: IPSEC_SA_ENUM_TEMPLATE0*
Modello per limitare in modo selettivo l'enumerazione.
[out] enumHandle
Tipo: HANDLE*
Handle dell'enumerazione appena creata.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
L'enumerazione è stata creata correttamente. |
|
Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore del WFP . |
|
Errore di comunicazione con il motore firewall remoto o locale. |
Commenti
Se enumTemplate è NULL, vengono restituiti tutti gli oggetti SA IPsec.
Il chiamante deve chiamare IPsecSaDestroyEnumHandle0 per liberare l'handle restituito.
Il chiamante deve FWPM_ACTRL_READ e FWPM_ACTRL_ENUM l'accesso al database delle associazioni di sicurezza IPsec. Per altre informazioni, vedere Controllo di accesso.
IPsecSaCreateEnumHandle0 è un'implementazione specifica di IPsecSaCreateEnumHandle. 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
| 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 |