struktur FWPM_FILTER0 (fwpmtypes.h)

Artikel
04/21/2023

Struktur FWPM_FILTER0 menyimpan status yang terkait dengan filter.

Sintaks

typedef struct FWPM_FILTER0_ {
  GUID                   filterKey;
  FWPM_DISPLAY_DATA0     displayData;
  UINT32                 flags;
  GUID                   *providerKey;
  FWP_BYTE_BLOB          providerData;
  GUID                   layerKey;
  GUID                   subLayerKey;
  FWP_VALUE0             weight;
  UINT32                 numFilterConditions;
  FWPM_FILTER_CONDITION0 *filterCondition;
  FWPM_ACTION0           action;
  union {
    UINT64 rawContext;
    GUID   providerContextKey;
  };
  GUID                   *reserved;
  UINT64                 filterId;
  FWP_VALUE0             effectiveWeight;
} FWPM_FILTER0;

Anggota

filterKey

Mengidentifikasi sesi secara unik.

Jika GUID diinisialisasi ke nol dalam panggilan ke FwpmFilterAdd0, Mesin Pemfilteran Dasar (BFE) akan menghasilkannya.

displayData

Struktur FWPM_DISPLAY_DATA0 yang berisi anotasi yang dapat dibaca manusia yang terkait dengan filter. Nama anggota struktur FWPM_DISPLAY_DATA0 diperlukan.

flags

Kombinasi nilai berikut.

Bendera filter	Makna
FWPM_FILTER_FLAG_NONE	Default.
FWPM_FILTER_FLAG_PERSISTENT	Filter persisten, yaitu bertahan di seluruh stop/start BFE. Catatan Bendera ini tidak dapat diatur bersama dengan FWPM_FILTER_FLAG_BOOTTIME.
FWPM_FILTER_FLAG_BOOTTIME	Filter diberlakukan pada waktu boot, bahkan sebelum BFE dimulai. Catatan Bendera ini tidak dapat diatur bersama dengan FWPM_FILTER_FLAG_PERSISTENT.
FWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXT	Filter mereferensikan konteks penyedia.
FWPM_FILTER_FLAG_CLEAR_ACTION_RIGHT	Hapus tindakan filter dengan benar.
FWPM_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED	Jika callout tidak terdaftar, filter diperlakukan sebagai filter izin. Catatan Bendera ini hanya dapat diatur jika jenis tindakan adalah FWP_ACTION_CALLOUT_TERMINATING atau FWP_ACTION_CALLOUT_UNKNOWN.
FWPM_FILTER_FLAG_DISABLED	Filter dinonaktifkan. Filter penyedia dinonaktifkan saat BFE dimulai jika penyedia tidak memiliki nama layanan Windows terkait, atau jika layanan terkait tidak diatur ke mulai otomatis. Catatan Bendera ini tidak dapat diatur saat menambahkan filter baru. Ini hanya dapat dikembalikan oleh BFE saat mendapatkan atau menghitung filter.
FWPM_FILTER_FLAG_INDEXED	Filter diindeks untuk membantu mengaktifkan pencarian yang lebih cepat selama klasifikasi. Catatan Hanya tersedia di Windows 8 dan Windows Server 2012.

providerKey

GUID opsional penyedia kebijakan yang mengelola filter ini. Lihat Pengidentifikasi Penyedia Bawaan untuk daftar penyedia kebijakan yang telah ditentukan sebelumnya.

providerData

Struktur FWP_BYTE_BLOB yang berisi data khusus penyedia opsional yang digunakan oleh penyedia untuk menyimpan informasi konteks tambahan dengan objek .

layerKey

GUID lapisan tempat filter berada. Lihat Memfilter Pengidentifikasi Lapisan untuk daftar nilai yang mungkin.

subLayerKey

GUID sub-lapisan tempat filter berada. Lihat Pemfilteran pengidentifikasi Sub-Layer untuk daftar sub-lapisan bawaan.

Jika ini diatur ke IID_NULL, filter ditambahkan ke sublayer default.

weight

Struktur FWP_VALUE0 yang menentukan bobot filter. Bobot menunjukkan prioritas filter, di mana bobot bernomor lebih tinggi memiliki prioritas yang lebih tinggi (dan akan dievaluasi sebelum filter berbobot lebih rendah).

Nilai jenis yang mungkin untuk berat adalah sebagai berikut.

berat jenis	Makna
FWP_UINT64	BFE akan menggunakan nilai yang disediakan sebagai bobot filter.
FWP_UINT8 0–15	BFE akan menggunakan nilai yang disediakan sebagai indeks rentang berat dan akan menghitung berat filter dalam rentang tersebut. Lihat Penetapan Bobot Filter untuk informasi selengkapnya.
FWP_EMPTY	BFE akan secara otomatis menetapkan bobot berdasarkan kondisi filter.

Lihat Pengidentifikasi Berat Filter untuk konstanta bawaan yang dapat digunakan untuk menghitung berat filter.

numFilterConditions

Jumlah kondisi filter.

filterCondition

Array struktur FWPM_FILTER_CONDITION0 yang berisi semua kondisi pemfilteran. Semua harus benar agar tindakan dilakukan. Dengan kata lain, kondisi dievaluasi menggunakan operator AND. Jika tidak ada kondisi yang ditentukan, tindakan selalu dilakukan.

**Catatan** Di Windows 7 dan Windows Server 2008 R2, kondisi berturut-turut dengan fieldKey yang sama akan dievaluasi menggunakan operator OR.

action

Struktur FWPM_ACTION0 yang menentukan tindakan yang akan dilakukan jika semua kondisi filter benar.

rawContext

Tersedia saat filter tidak memiliki informasi konteks penyedia, yaitu , bendera tidak berisi FWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXT. Lihat Memfilter Pengidentifikasi Konteks untuk daftar nilai bawaan yang mungkin.

RawContext ditempatkan 'apa adanya' dalam anggota konteks struktur FWPS_FILTER0 yang sesuai, yang di dokumentasikan dalam WDK.

providerContextKey

Tersedia saat filter memiliki informasi konteks penyedia, yaitu , bendera berisi FWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXT. Lihat Pengidentifikasi Konteks Penyedia Bawaan untuk daftar konteks penyedia kebijakan yang telah ditentukan sebelumnya.

LUID konteks penyedia yang ditentukan oleh providerContextKey digunakan untuk mengisi anggota konteks struktur FWPS_FILTER0 yang sesuai, yang didokumentasikan dalam WDK.

reserved

Dicadangkan untuk penggunaan sistem.

filterId

LUID mengidentifikasi filter. Ini juga MERUPAKAN LUID dari struktur FWPS_FILTER0 yang sesuai, yang di dokumentasikan dalam WDK.

effectiveWeight

Struktur FWP_VALUE0 yang berisi bobot yang ditetapkan ke FWPS_FILTER0, yang di dokumentasikan dalam WDK.

Keterangan

Sepuluh anggota pertama struktur ini berisi informasi yang disediakan saat menambahkan objek.

Anggota terakhir, filterId , dan effectiveWeight, memberikan informasi tambahan saat mendapatkan/menghitung objek.

FWPM_FILTER0 adalah implementasi khusus dari FWPM_FILTER. 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]
Header	fwpmtypes.h

Lihat juga

FWPM_ACTION0

FWPM_DISPLAY_DATA0

FWPM_FILTER_CONDITION0

FWP_VALUE0

Penetapan Bobot Filter

Pengidentifikasi Bobot Filter

Struktur API Platform Pemfilteran Windows

Bendera filter	Makna
FWPM_FILTER_FLAG_NONE	Default.
FWPM_FILTER_FLAG_PERSISTENT	Filter persisten, yaitu bertahan di seluruh stop/start BFE. Catatan Bendera ini tidak dapat diatur bersama dengan FWPM_FILTER_FLAG_BOOTTIME.
FWPM_FILTER_FLAG_BOOTTIME	Filter diberlakukan pada waktu boot, bahkan sebelum BFE dimulai. Catatan Bendera ini tidak dapat diatur bersama dengan FWPM_FILTER_FLAG_PERSISTENT.
FWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXT	Filter mereferensikan konteks penyedia.
FWPM_FILTER_FLAG_CLEAR_ACTION_RIGHT	Hapus tindakan filter dengan benar.
FWPM_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED	Jika callout tidak terdaftar, filter diperlakukan sebagai filter izin. Catatan Bendera ini hanya dapat diatur jika jenis tindakan adalah FWP_ACTION_CALLOUT_TERMINATING atau FWP_ACTION_CALLOUT_UNKNOWN.
FWPM_FILTER_FLAG_DISABLED	Filter dinonaktifkan. Filter penyedia dinonaktifkan saat BFE dimulai jika penyedia tidak memiliki nama layanan Windows terkait, atau jika layanan terkait tidak diatur ke mulai otomatis. Catatan Bendera ini tidak dapat diatur saat menambahkan filter baru. Ini hanya dapat dikembalikan oleh BFE saat mendapatkan atau menghitung filter.
FWPM_FILTER_FLAG_INDEXED	Filter diindeks untuk membantu mengaktifkan pencarian yang lebih cepat selama klasifikasi. Catatan Hanya tersedia di Windows 8 dan Windows Server 2012.