Fonction IoReplaceFileObjectName (ntifs.h)

La routine IoReplaceFileObjectName remplace le nom d’un objet de fichier.

Syntaxe

NTSTATUS IoReplaceFileObjectName(
  [in] PFILE_OBJECT FileObject,
  [in] PWSTR        NewFileName,
  [in] USHORT       FileNameLength
);

Paramètres

[in] FileObject

Pointeur vers l’objet de fichier dont le nom de fichier est en cours de remplacement.

[in] NewFileName

Pointeur vers la mémoire tampon de chaîne pour le nouveau nom de l’objet fichier.

[in] FileNameLength

Longueur, en octets, du nouveau nom de l’objet fichier.

Valeur retournée

Retourne STATUS_SUCCESS ou l’une des valeurs NTSTATUS suivantes :

Remarques

Les pilotes doivent utiliser IoReplaceFileObjectName pour remplacer en toute sécurité le nom dans un objet de fichier. Cela permet au gestionnaire d’E/S de contrôler la durée de vie de la mémoire tampon associée à l’objet de fichier. Le remplacement direct d’un nom d’objet de fichier sans utiliser IoReplaceFileObjectName peut entrer en conflit avec d’autres utilisations du nom et doit être évité lorsque cela est possible.

Cette routine doit être utilisée pour remplacer le nom de l’objet de fichier au lieu de le faire manuellement pour permettre au noyau de gérer correctement la durée de vie du nom.

Configuration requise