Fungsi FwpmProviderAdd0 (fwpmu.h)

Artikel
03/05/2024

Fungsi FwpmProviderAdd0 menambahkan penyedia baru ke sistem.

Sintaks

DWORD FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

Parameter

[in] engineHandle

Jenis: HANDEL

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

[in] provider

Jenis: FWPM_PROVIDER0*

Objek penyedia yang akan ditambahkan.

[in, optional] sd

Jenis: PSECURITY_DESCRIPTOR

Informasi keamanan untuk objek penyedia.

Nilai kembali

Jenis: DWORD

Mengembalikan kode/nilai	Deskripsi
ERROR_SUCCESS 0	Penyedia berhasil ditambahkan.
*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

Jika penelepon menyediakan deskriptor keamanan null, sistem akan menetapkan pendeskripsi keamanan default.

Objek waktu boot ditambahkan ke Mesin Pemfilteran Dasar (BFE) ketika driver TCP/IP dimulai, dan dihapus setelah BFE menyelesaikan inisialisasi. Objek persisten ditambahkan saat BFE dimulai. Jika penyedia kebijakan memiliki kebijakan persisten yang tidak dimaksudkan untuk diberlakukan jika layanan terkait dinonaktifkan, pemanggil dapat menentukan nama layanan opsional dalam struktur FWPM_PROVIDER0 . Layanan ini kemudian memiliki objek kebijakan persisten. Pada awalnya, BFE hanya menambahkan jenis objek persisten berikut ke sistem.

Objek tidak terkait dengan penyedia.
Objek memiliki penyedia terkait yang tidak menentukan nama layanan.
Objek memiliki penyedia terkait dan layanan terkait yang diatur ke mulai otomatis.

Fungsi ini tidak dapat dipanggil dari dalam transaksi baca-saja. Ini akan gagal dengan FWP_E_INCOMPATIBLE_TXN. Lihat Manajemen Objek untuk informasi selengkapnya tentang transaksi.

Pemanggil membutuhkan akses FWPM_ACTRL_ADD ke kontainer penyedia. Lihat Access Control untuk informasi selengkapnya.

FwpmProviderAdd0 adalah implementasi khusus dari FwpmProviderAdd. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu 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

FWPM_PROVIDER0

Bagikan melalui