Fungsi FwpmCalloutAdd0 (fwpmu.h)

Artikel
08/23/2023

Fungsi FwpmCalloutAdd0 menambahkan objek callout baru ke sistem.

Sintaks

DWORD FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

Parameter

[in] engineHandle

Jenis: HANDEL

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

[in] callout

Jenis: FWPM_CALLOUT0*

Objek callout yang akan ditambahkan.

[in, optional] sd

Jenis: PSECURITY_DESCRIPTOR

Informasi keamanan yang terkait dengan callout.

[out, optional] id

Jenis: UINT32*

Pengidentifikasi runtime untuk callout ini.

Mengembalikan nilai

Jenis: DWORD

Mengembalikan kode/nilai	Deskripsi
ERROR_SUCCESS 0	Callout berhasil ditambahkan.
FWP_E_INVALID_PARAMETER 0x80320035	FWPM_TUNNEL_FLAG_POINT_TO_POINT tidak diatur dan kondisi selain alamat lokal/jarak jauh ditentukan.
kode kesalahan FWP_E_* 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

Beberapa bidang dalam struktur FWPM_CALLOUT0 ditetapkan oleh sistem, bukan pemanggil, dan diabaikan dalam panggilan ke FwpmCalloutAdd0. Jika penelepon menyediakan deskriptor keamanan null, sistem akan menetapkan deskriptor keamanan default.

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 memerlukan akses FWPM_ACTRL_ADD ke kontainer callout, FWPM_ACTRL_ADD_LINK akses ke penyedia (jika ada), dan FWPM_ACTRL_ADD_LINK akses ke lapisan yang berlaku. Lihat Access Control untuk informasi selengkapnya.

Untuk menambahkan filter yang mereferensikan callout, panggil fungsi dalam urutan berikut.

Panggil FwpsCalloutRegister (didokumenkan dalam Windows Driver Kit (WDK)), untuk mendaftarkan callout dengan mesin filter.
Panggil FwpmCalloutAdd0 untuk menambahkan callout ke sistem.
Panggil FwpmFilterAdd0 untuk menambahkan filter yang mereferensikan callout ke sistem.

Secara default filter yang mereferensikan callout yang telah ditambahkan tetapi belum terdaftar di mesin filter diperlakukan sebagai filter Blokir.

FwpmCalloutAdd0 adalah implementasi khusus dari FwpmCalloutAdd. 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_CALLOUT0

Mode Kernel FwpmCalloutAdd0

Bagikan melalui