Fonction FltUntagFile (fltkernel.h)

Article
02/26/2024

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 de instance opaque pour le pilote minifilter instance qui a lancé cette demande d’E/S. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] FileObject

Pointeur vers un objet file pour le fichier ou le répertoire à partir duquel le point d’analyse doit être supprimé. L’objet file doit être ouvert pour un accès FILE_WRITE_DATA. 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 retournée

FltUntagFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour	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 correspondait pas au GUID du point d’analyse à supprimer. Il s’agit d’un code d’erreur.