FltUntagFile 函式 (fltkernel.h)

發行項
02/26/2024

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 值，例如下列其中一項：

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