Fungsi FwpsClassifyOptionSet0 (fwpsk.h)

Artikel
08/07/2023

Fungsi FwpsClassifyOptionSet0 dipanggil oleh fungsi classifyFn filter callout untuk menentukan informasi tambahan yang memengaruhi karakteristik operasi pemfilteran yang diizinkan.

CatatanFwpsClassifyOptionSet0 adalah versi tertentu dari FwpsClassifyOptionSet. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

NTSTATUS FwpsClassifyOptionSet0(
  [in] const FWPS_INCOMING_METADATA_VALUES0 *inMetadataValues,
  [in] const FWP_CLASSIFY_OPTION_TYPE       option,
  [in] const FWP_VALUE0                     *newValue
);

Parameter

[in] inMetadataValues

Penunjuk ke struktur FWPS_INCOMING_METADATA_VALUES0 . Struktur ini berisi nilai untuk setiap bidang metadata pada lapisan yang sedang difilter.

[in] option

Konstanta enumerasi FWP_CLASSIFY_OPTION_TYPE yang menunjukkan apakah parameter newValue mengacu pada status pemetaan sumber unicast, multicast, atau longgar, atau ke nilai batas waktu data. Untuk informasi selengkapnya, lihat Keterangan.

[in] newValue

Penunjuk ke array struktur FWP_VALUE0 . Setiap struktur dalam array berisi nilai tertentu untuk konstanta FWP_OPTION_VALUE_XXX tertentu. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

Fungsi FwpsClassifyOptionSet0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil diselesaikan.
STATUS_FWP_INVALID_ENUMERATOR	Parameter opsi tidak cocok dengan salah satu nilai dalam FWP_CLASSIFY_OPTION_TYPE enumerasi.
STATUS_FWP_OUT_OF_BOUNDS	Nilai opsi yang ditentukan oleh newValue -> uint32 tidak menyertakan salah satu nilai konstanta FWP_OPTION_VALUE_XXX yang ditentukan.
STATUS_OBJECT_TYPE_MISMATCH	Tipe data yang ditentukan olehTipeNilai -> baru tidak FWP_UINT32.
STATUS_UNSUCCESSFUL	Terjadi kesalahan umum.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Fungsi ini harus dipanggil hanya oleh fungsi classifyFn filter callout.

Berikut ini adalah nilai yang diizinkan dari parameter opsi dan anggota struktur FWP_VALUE0 yang ditujukkan oleh parameter newValue .

Pilihan Parameter	nilai jenis newValue->	nilai uint32 newValue->
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Aktifkan pemetaan sumber longgar. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Nonaktifkan pemetaan sumber longgar.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Izinkan pembuatan status multicast lokal tautan pada lalu lintas keluar. FWP_OPTION_VALUE_DENY_MULTICAST_STATE Jangan izinkan pembuatan status multicast lokal tautan pada lalu lintas keluar. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Izinkan pembuatan status multicast untuk lalu lintas keluar (mengizinkan respons non-link-local).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Menentukan masa pakai status multicast/broadcast, dalam detik.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Menentukan masa pakai status unicast, dalam detik.

Penelepon pertama (berat tertinggi) untuk mengatur opsi tertentu akan diberikan opsi tersebut. Misalnya, jika callout A mengatur opsi status multicast, callout B tidak akan dapat melakukannya, tetapi callout B dapat mengatur opsi lain.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	fwpsk.h (termasuk Fwpsk.h)
Pustaka	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL