FltUntagFile-Funktion (fltkernel.h)

Artikel
03/01/2024

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 instance Zeiger für den Minifiltertreiber instance, der diese E/A-Anforderung initiiert hat. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] FileObject

Zeiger 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 darf nicht NULL sein.

[in] FileTag

Analysepunkttag. Das in diesem Parameter angegebene Tag muss mit dem Tag des zu entfernenden Analysepunkts übereinstimmen.

[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 darf nicht NULL sein. Die in diesem Parameter angegebene GUID muss mit der GUID des zu entfernenden Analysepunkts übereinstimmen.

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 stimmte nicht mit dem Tag des zu löschenden Analysepunkts überein. Dies ist ein Fehlercode.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Die vom Aufrufer angegebene Analyse-GUID stimmte nicht mit der GUID des zu löschenden Analysepunkts überein. Dies ist ein Fehlercode.