FltUntagFile-Funktion (fltkernel.h)

Artikel
02/06/2025

FltUntagFile entfernt einen Analysepunkt aus einer Datei oder einem Verzeichnis.

Syntax

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

Parameter

[in] InitiatingInstance

Undurchsichtiger Instanzzeiger für die Minifiltertreiberinstanz, die diese E/A-Anforderung initiiert hat. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] FileObject

Zeigen Sie auf ein Dateiobjekt für die Datei oder das Verzeichnis, aus dem der Analysepunkt entfernt werden soll. Das Dateiobjekt muss für FILE_WRITE_DATA Zugriff geöffnet werden. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] FileTag

Analysepunkttag. Das in diesem Parameter angegebene Tag muss mit dem Tag des analysepunkts übereinstimmen, der entfernt werden soll.

[in, optional] Guid

GUID (Globally Unique Identifier), die den Typ des Analysepunkts eindeutig identifiziert. Wenn FileTag- kein Microsoft-Tag ist, ist dieser Parameter erforderlich und kann nicht NULL-werden. Die in diesem Parameter angegebene GUID muss mit der GUID des analysepunkts übereinstimmen, der entfernt werden soll.

Rückgabewert

FltUntagFile- gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_IO_REPARSE_TAG_MISMATCH	Das vom Aufrufer angegebene Analysetag entspricht nicht dem Tag des zu löschenden Analysepunkts. Dies ist ein Fehlercode.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Die durch den Aufrufer angegebene Analyse-GUID entspricht nicht der GUID des zu löschenden Analysepunkts. Dies ist ein Fehlercode.