Condividi tramite

Funzione IPsecSaContextCreate0 (fwpmk.h)

  • Articolo

La funzione IPsecSaContextCreate0 crea un contesto dell'associazione di sicurezza IPsec.

Sintassi

NTSTATUS IPsecSaContextCreate0(
  [in]            HANDLE               engineHandle,
  [in]            const IPSEC_TRAFFIC0 *outboundTraffic,
  [out, optional] UINT64               *inboundFilterId,
  [out]           UINT64               *id
);

Parametri

[in] engineHandle

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] outboundTraffic

Traffico in uscita dell'amministratore di sistema.

[out, optional] inboundFilterId

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 quando BFE non ha un valore memorizzato nella cache, nel qual caso questo parametro verrà impostato su 0.

[out] id

Identificatore del contesto sa IPsec.

Valore restituito

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 WFP.
RPC_* codice di errore
0x80010001: 0x80010122		 Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS Si è verificato un errore.

Osservazioni

Questa funzione non può essere chiamata dall'interno di una transazione, ma ha 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 ha 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 di controllo di accesso.

IPsecSaContextCreate0 è un'implementazione specifica di IPsecSaContextCreate. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows Vista.
piattaforma di destinazione Universale
intestazione fwpmk.h
libreria fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Vedere anche