Funzione IPsecSaContextCreate1 (fwpmu.h)

Articolo
02/26/2024

La funzione IPsecSaContextCreate1 crea un contesto dell'associazione di sicurezza (SA) IPsec.

NotaIPsecSaContextCreate1 è l'implementazione specifica di IPsecSaContextCreate 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 IPsecSaContextCreate0 .

Sintassi

DWORD IPsecSaContextCreate1(
  [in]            HANDLE                              engineHandle,
  [in]            const IPSEC_TRAFFIC1                *outboundTraffic,
  [in, optional]  const IPSEC_VIRTUAL_IF_TUNNEL_INFO0 *virtualIfTunnelInfo,
  [out, optional] UINT64                              *inboundFilterId,
  [out]           UINT64                              *id
);

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] outboundTraffic

Tipo: IPSEC_TRAFFIC1*

Traffico in uscita dell'amministratore di sistema.

[in, optional] virtualIfTunnelInfo

Tipo: IPSEC_VIRTUAL_IF_TUNNEL_INFO0*

Dettagli relativi al tunneling dell'interfaccia virtuale.

[out, optional] inboundFilterId

Tipo: UINT64*

Identificatore di filtro facoltativo del filtro in ingresso memorizzato nella cache corrispondente al parametro outboundTraffic specificato dal chiamante. Il motore di filtro di base (BFE) può memorizzare nella cache l'identificatore del filtro in ingresso e restituire il valore memorizzato nella cache, se disponibile. Il chiamante deve gestire il caso in cui BFE non ha un valore memorizzato nella cache, nel qual caso questo parametro verrà impostato su 0.

[out] id

Tipo: UINT64*

Identificatore del contesto SA IPsec.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il contesto SA IPsec è stato creato 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

Questa funzione non può essere chiamata dall'interno di una transazione. Avrà esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedere Gestione oggetti.

Questa funzione non può essere chiamata dall'interno di una sessione dinamica. La chiamata avrà esito negativo con FWP_E_DYNAMIC_SESSION_IN_PROGRESS. Per altre informazioni sulle sessioni dinamiche, vedere Gestione oggetti.

Il chiamante deve FWPM_ACTRL_ADD l'accesso al database delle associazioni di sicurezza IPsec. Per altre informazioni, vedere Controllo di accesso.

Requisiti

Requisito	Valore
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_TRAFFIC1

IPSEC_VIRTUAL_IF_TUNNEL_INFO0

Condividi tramite