Fungsi FltUntagFile (fltkernel.h)

Artikel
02/29/2024

FltUntagFile menghapus titik penguraian ulang dari file atau direktori.

Sintaks

NTSTATUS FLTAPI FltUntagFile(
  [in]           PFLT_INSTANCE InitiatingInstance,
  [in]           PFILE_OBJECT  FileObject,
  [in]           ULONG         FileTag,
  [in, optional] GUID          *Guid
);

Parameter

[in] InitiatingInstance

Penunjuk instans buram untuk instans driver minifilter yang memulai permintaan I/O ini. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk ke objek file untuk file atau direktori tempat titik pemisahan ulang akan dihapus. Objek file harus dibuka untuk akses FILE_WRITE_DATA. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileTag

Pilah ulang tag titik. Tag yang ditentukan dalam parameter ini harus cocok dengan tag titik pemilah ulang yang akan dihapus.

[in, optional] Guid

Pengidentifikasi unik global (GUID) yang secara unik mengidentifikasi jenis titik pemilah ulang. Jika FileTag bukan tag Microsoft, parameter ini diperlukan dan tidak boleh NULL. GUID yang ditentukan dalam parameter ini harus cocok dengan GUID dari titik pemisahan ulang yang akan dihapus.

Nilai kembali

FltUntagFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_IO_REPARSE_TAG_MISMATCH	Tag reparse yang ditentukan oleh pemanggil tidak cocok dengan tag titik reparse yang akan dihapus. Ini adalah kode kesalahan.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	GUID reparse yang ditentukan oleh pemanggil tidak cocok dengan GUID dari titik reparse yang akan dihapus. Ini adalah kode kesalahan.