FltUntagFile-Funktion (fltkernel.h)

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:

Bemerkungen

Minifiltertreiber sollten FltUntagFile- anstelle von FSCTL_DELETE_REPARSE_POINT verwenden, um einen Analysepunkt zu löschen.

Ein Minifiltertreiber kann ein Analysetag für eine Datei oder ein Verzeichnis festlegen, indem FltTagFile-aufgerufen wird.

Weitere Informationen zu Analysepunkten finden Sie in der Dokumentation zum Microsoft Windows SDK.

Anforderungen

Siehe auch

FLT_TAG_DATA_BUFFER

FSCTL_DELETE_REPARSE_POINT

FSCTL_GET_REPARSE_POINT

FSCTL_SET_REPARSE_POINT

FltTagFile-

IsReparseTagMicrosoft

IsReparseTagNameSurrogate-