Condividi tramite

Funzione IkeextSaGetById1 (fwpmk.h)

  • Articolo

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

Sintassi

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

Parametri

[in] engineHandle

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

[in] id

Identificatore sa.

[in., optional] saLookupContext

Puntatore facoltativo al contesto di ricerca dell'amministratore di sistema 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 l'API Winsock WSAQuerySocketSecurity funzione, consentendo all'applicazione di ottenere informazioni dettagliate sull'autenticazione IPsec per la connessione.

[out] sa

Indirizzo dei dettagli dell'amministratore di sistema.

Valore restituito

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

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 di controllo di accesso.

IkeextSaGetById1 è un'implementazione specifica di IkeextSaGetById. 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