Funzione IPsecSaContextGetById0 (fwpmu.h)
La funzione IPsecSaContextGetById0 recupera un contesto dell'associazione di sicurezza (SA) IPsec.
NotaIPsecSaContextGetById0 è l'implementazione specifica di IPsecSaContextGetById usata in Windows Vista. 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 7 e versioni successive, è disponibile IPsecSaContextGetById1 .
Sintassi
DWORD IPsecSaContextGetById0(
[in] HANDLE engineHandle,
[in] UINT64 id,
[out] IPSEC_SA_CONTEXT0 **saContext
);
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] id
Tipo: UINT64
Identificatore di runtime per il contesto sa. Questo identificatore è stato ricevuto dal sistema quando l'applicazione ha chiamato IPsecSaContextCreate0.
[out] saContext
Tipo: IPSEC_SA_CONTEXT0**
Indirizzo del contesto SA IPsec.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
Il contesto SA IPsec è stato recuperato 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
Il chiamante deve liberare l'oggetto restituito, saContext, da una chiamata a FwpmFreeMemory0.
Il chiamante deve FWPM_ACTRL_READ l'accesso al database delle associazioni di sicurezza IPsec. Per altre informazioni, vedere Controllo di accesso.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |