Funzione IkeextSaGetById2 (fwpmu.h)

Articolo
08/23/2023

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

NotaIkeextSaGetById2 è l'implementazione specifica di IkeextSaGetById usata in Windows 8. 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, IkeextSaGetById1 è disponibile. Per Windows Vista, È disponibile IkeextSaGetById0 .

Sintassi

DWORD IkeextSaGetById2(
  [in]           HANDLE             engineHandle,
  [in]           UINT64             id,
  [in, optional] GUID               *saLookupContext,
  [out]          IKEEXT_SA_DETAILS2 **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 dall'amministratore di sistema alle connessioni dati che passano attraverso tale sa. Viene reso disponibile per qualsiasi applicazione che esegue query sulle proprietà di sicurezza del socket usando la funzione WSAQuerySocketSecurity dell'API Winsocket , consentendo all'applicazione di ottenere informazioni dettagliate sull'autenticazione IPsec per la connessione.

[out] sa

Tipo: IKEEXT_SA_DETAILS2**

Indirizzo dei dettagli dell'amministratore di sistema.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'amministratore di sistema è stato recuperato 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

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 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

IKEEXT_SA_DETAILS2

Condividi tramite