code de contrôle FSCTL_DELETE_REPARSE_POINT

Article
03/14/2023

Le code de contrôle FSCTL_DELETE_REPARSE_POINT supprime un point d’analyse du fichier ou du répertoire spécifié. L’utilisation de FSCTL_DELETE_REPARSE_POINT ne supprime pas le fichier ou le répertoire.

Pour effectuer cette opération, appelez ZwFsControlFile avec les paramètres suivants.

Les minifiltres doivent utiliser FltUntagFile au lieu de FSCTL_DELETE_REPARSE_POINT pour supprimer un point d’analyse.

Pour plus d’informations sur les points d’analyse et le code de contrôle FSCTL_DELETE_REPARSE_POINT, consultez la documentation Microsoft Windows SDK.

Paramètres

FileHandle [in] : handle de fichier pour le fichier ou le répertoire à partir duquel le point d’analyse doit être supprimé. L’appelant doit avoir un accès en écriture au fichier ou au répertoire. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FsControlCode [in] : code de contrôle pour l’opération. Utilisez FSCTL_DELETE_REPARSE_POINT pour cette opération.
InputBuffer [in] : pointeur vers une structure REPARSE_GUID_DATA_BUFFER ou REPARSE_DATA_BUFFER . La balise spécifiée dans le membre ReparseTag de cette structure doit correspondre à la balise du point d’analyse à supprimer, et le membre ReparseDataLength doit être égal à zéro. En outre, si le point d’analyse est un point d’analyse tiers (non-Microsoft), le GUID spécifié dans le membre ReparseGuid de la structure REPARSE_GUID_DATA_BUFFER doit correspondre au GUID du point d’analyse à supprimer.
InputBufferLength [in] : taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre InputBuffer . Pour une structure REPARSE_GUID_DATA_BUFFER, cette valeur doit être exactement REPARSE_GUID_DATA_BUFFER_HEADER_SIZE. Pour une structure REPARSE_DATA_BUFFER, cette valeur doit être exactement REPARSE_DATA_BUFFER_HEADER_SIZE.
OutputBuffer [out] : Aucun. valeur de l’en-tête définie sur Null.
OutputBufferLength [out] : défini sur 0.

Bloc d’état

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

Code	Signification
STATUS_IO_REPARSE_DATA_INVALID	L’une des valeurs de paramètre spécifiées n’était pas valide. Il s’agit d’un code d’erreur.
STATUS_IO_REPARSE_TAG_INVALID	La balise d’analyse spécifiée par l’appelant n’était pas valide. Il s’agit d’un code d’erreur.
STATUS_IO_REPARSE_TAG_MISMATCH	La balise d’analyse spécifiée par l’appelant ne correspond pas à la balise du point d’analyse à supprimer. Il s’agit d’un code d’erreur.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Le point d’analyse est un point d’analyse tiers, et 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.