Fungsi FwpmNetEventSubscribe0 (fwpmu.h)

Artikel
29/02/2024

Fungsi FwpmNetEventSubscribe0 digunakan untuk meminta pengiriman pemberitahuan mengenai peristiwa net tertentu.

CatatanFwpmNetEventSubscribe0 adalah implementasi spesifik dari FwpmNetEventSubscribe yang digunakan di Windows 7. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 8, FwpmNetEventSubscribe1 tersedia.

Sintaks

DWORD FwpmNetEventSubscribe0(
  [in]           HANDLE                             engineHandle,
  [in]           const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  [in]           FWPM_NET_EVENT_CALLBACK0           callback,
  [in, optional] void                               *context,
  [out]          HANDLE                             *eventsHandle
);

Parameter

[in] engineHandle

Jenis: HANDEL

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

[in] subscription

Jenis: FWPM_NET_EVENT_SUBSCRIPTION0*

Pemberitahuan yang akan dikirimkan.

[in] callback

Jenis: FWPM_NET_EVENT_CALLBACK0

Penunjuk fungsi yang akan dipanggil ketika pemberitahuan siap untuk pengiriman.

[in, optional] context

Jenis: void*

Penunjuk konteks opsional. Pointer ini diteruskan ke fungsi panggilan balik bersama dengan detail peristiwa.

[out] eventsHandle

Jenis: HANDLE*

Tangani ke langganan yang baru dibuat.

Mengembalikan nilai

Jenis: DWORD

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

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

Pemanggil membutuhkan akses FWPM_ACTRL_SUBSCRIBE ke kontainer peristiwa net.

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

FWPM_NET_EVENT_CALLBACK0

FWPM_NET_EVENT_SUBSCRIPTION0

FwpmNetEventUnsubscribe0

Bagikan melalui