FltUntagFile 函式（fltkernel.h）

發行項
02/06/2025

FltUntagFile 會從檔案或目錄移除重新分析點。

語法

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

參數

[in] InitiatingInstance

起始此 I/O 要求之迷你篩選驅動程序實例的不透明實例指標。這是必要參數，而且無法 NULL。

[in] FileObject

要從中移除重新分析點之檔案或目錄的檔案對象指標。檔案對象必須開啟才能存取FILE_WRITE_DATA。這是必要參數，而且無法 NULL。

[in] FileTag

重新剖析點標記。此參數中指定的標記必須符合要移除之重新分析點的標記。

[in, optional] Guid

可唯一識別重新分析點類型的全域唯一標識碼（GUID）。如果 FileTag 不是Microsoft標籤，則需要此參數，而且無法 NULL。此參數中指定的 GUID 必須符合要移除之重新分析點的 GUID。

傳回值

FltUntagFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	描述
STATUS_IO_REPARSE_TAG_MISMATCH	呼叫端指定的重新剖析標記不符合要刪除之重新分析點的標記。這是錯誤碼。
STATUS_REPARSE_ATTRIBUTE_CONFLICT	呼叫端所指定的重新剖析 GUID 不符合要刪除之重新分析點的 GUID。這是錯誤碼。