FltUntagFile, fonction (fltkernel.h)

Article
02/06/2025

FltUntagFile supprime un point d’analyse d’un fichier ou d’un répertoire.

Syntaxe

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

Paramètres

[in] InitiatingInstance

Pointeur d’instance opaque pour l’instance de pilote minifilter qui a lancé cette requête d’E/S. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] FileObject

Pointeur vers un objet de fichier pour le fichier ou le répertoire à partir duquel le point d’analyse doit être supprimé. L’objet fichier doit être ouvert pour FILE_WRITE_DATA accès. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] FileTag

Balise de point d’analyse. La balise spécifiée dans ce paramètre doit correspondre à la balise du point d’analyse à supprimer.

[in, optional] Guid

Identificateur global unique (GUID) qui identifie de manière unique le type de point d’analyse. Si fileTag n’est pas une balise Microsoft, ce paramètre est obligatoire et ne peut pas être NULL. Le GUID spécifié dans ce paramètre doit correspondre au GUID du point d’analyse à supprimer.

Valeur de retour

FltUntagFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Retourner le code	Description
STATUS_IO_REPARSE_TAG_MISMATCH	La balise d’analyse spécifiée par l’appelant ne correspondait pas à la balise du point d’analyse à supprimer. Il s’agit d’un code d’erreur.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Le GUID d’analyse spécifié par l’appelant ne correspond pas au GUID du point d’analyse à supprimer. Il s’agit d’un code d’erreur.