Bagikan melalui

Fungsi IkeextSaGetById0 (fwpmu.h)

  • Artikel

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

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

Sintaks

DWORD IkeextSaGetById0(
  [in]  HANDLE             engineHandle,
  [in]  UINT64             id,
  [out] IKEEXT_SA_DETAILS0 **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.

[out] sa

Jenis: IKEEXT_SA_DETAILS0**

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 Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header fwpmu.h
Pustaka Fwpuclnt.lib
DLL Fwpuclnt.dll

Lihat juga

Fungsi IKE/AuthIP

IKEEXT_SA_DETAILS0

Fungsi WFP