Fungsi IkeextSaGetById1 (fwpmu.h)

Artikel
02/26/2024

Fungsi IkeextSaGetById1 mengambil asosiasi keamanan IKE/AuthIP (SA) dari database.

CatatanIkeextSaGetById1 adalah implementasi spesifik dari IkeextSaGetById yang digunakan di Windows 7. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 8, IkeextSaGetById2 tersedia. Untuk Windows Vista, IkeextSaGetById0 tersedia.

Sintaks

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

Parameter

[in] engineHandle

Jenis: HANDEL

Tangani untuk sesi terbuka ke mesin filter. Panggil FwpmEngineOpen0 untuk membuka sesi ke mesin filter.

[in] id

Jenis: UINT64

Pengidentifikasi SA.

[in, optional] saLookupContext

Jenis: GUID*

Penunjuk opsional ke konteks pencarian SA yang disebarkan dari SA ke koneksi data yang mengalir di SA tersebut. Ini tersedia untuk aplikasi apa pun yang meminta properti keamanan soket menggunakan fungsi Winsock API WSAQuerySocketSecurity , memungkinkan aplikasi untuk mendapatkan informasi autentikasi IPsec terperinci untuk koneksinya.

[out] sa

Jenis: IKEEXT_SA_DETAILS1**

Alamat detail SA.

Nilai kembali

Jenis: DWORD

Mengembalikan kode/nilai	Deskripsi
ERROR_SUCCESS 0	SA berhasil diambil.
*FWP_E_ kode kesalahan** 0x80320001—0x80320039	Kesalahan spesifik Windows Filtering Platform (WFP). Lihat Kode Kesalahan WFP untuk detailnya.
*RPC_ kode kesalahan** 0x80010001—0x80010122	Gagal berkomunikasi dengan mesin firewall jarak jauh atau lokal.

Keterangan

Penelepon harus membebaskan sa dengan panggilan ke FwpmFreeMemory0.

Pemanggil memerlukan akses FWPM_ACTRL_READ ke database asosiasi keamanan IKE/AuthIP. Lihat Access Control untuk informasi selengkapnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	fwpmu.h
Pustaka	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Lihat juga

Fungsi IKE/AuthIP

IKEEXT_SA_DETAILS1

Fungsi WFP

Bagikan melalui