Fungsi FwpsAcquireClassifyHandle0 (fwpsk.h)

Fungsi FwpsAcquireClassifyHandle0 menghasilkan handel klasifikasi yang digunakan untuk mengidentifikasi operasi klasifikasi asinkron dan permintaan untuk data lapisan yang dapat ditulis.

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

 

Sintaks

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

Parameter

[in] classifyContext

Parameter classifyContext dari classifyFn1. Mesin WFP meneruskan nilai ini ke classifyFn driver callout.

[in] flags

Disiapkan untuk penggunaan masa mendatang. Atur ke 0.

[out] classifyHandle

Penunjuk ke variabel yang menerima handel klasifikasi. Handel ini diperlukan oleh panggilan fungsi berikutnya seperti yang dicatat dalam Keterangan.

Nilai kembali

Fungsi FwpsAcquireClassifyHandle0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Handel ke permintaan klasifikasi berhasil dikembalikan. Variabel yang ditujukan parameter classifyHandle berisi handel untuk permintaan klasifikasi.
Kode status lainnya	Terjadi kesalahan.

Keterangan

FwpsAcquireClassifyHandle0 adalah fungsi dukungan untuk klasifikasi asinkron dan modifikasi data. Handel yang dikembalikan oleh fungsi ini diperlukan sebagai parameter untuk fungsi berikut:

• FwpsPendClassify0

• FwpsAcquireWritableLayerDataPointer0
• FwpsApplyModifiedLayerData0

• FwpsCompleteClassify0

• FwpsReleaseClassifyHandle0

Untuk setiap panggilan ke fungsi ini, driver callout harus memanggil FwpsReleaseClassifyHandle0 untuk membebaskan sumber daya sistem yang terkait dengan handel.

Persyaratan

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

Lihat juga

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifyFn1