Funzione IkeextSaGetById1 (fwpmu.h)

Articolo
02/29/2024

La funzione IkeextSaGetById1 recupera un'associazione di sicurezza IKE/AuthIP dal database.

NotaIkeextSaGetById1 è l'implementazione specifica di IkeextSaGetById usato in Windows 7. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows . Per Windows 8, è disponibile IkeextSaGetById2. Per Windows Vista, è disponibile IkeextSaGetById0 .

Sintassi

DWORD IkeextSaGetById1(
  [in]           HANDLE             engineHandle,
  [in]           UINT64             id,
  [in, optional] GUID               *saLookupContext,
  [out]          IKEEXT_SA_DETAILS1 **sa
);

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 SA.

[in, optional] saLookupContext

Tipo: GUID*

Puntatore facoltativo al contesto di ricerca SA propagato dalla sa alle connessioni dati che fluiscono su tale sa. Viene resa disponibile per qualsiasi applicazione che esegue query sulle proprietà di sicurezza del socket usando la funzione WSAQuerySocketSecurity dell'applicazione, consentendo all'applicazione di ottenere informazioni dettagliate sull'autenticazione IPsec per la connessione.

[out] sa

Tipo: IKEEXT_SA_DETAILS1**

Indirizzo dei dettagli della sa.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	La sa è stata recuperata 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	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

Il chiamante deve liberare sa tramite una chiamata a FwpmFreeMemory0.

Il chiamante deve FWPM_ACTRL_READ l'accesso al database delle associazioni di sicurezza IKE/AuthIP. 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

Funzioni IKE/AuthIP

IKEEXT_SA_DETAILS1

Funzioni WFP

Condividi tramite