Partager via


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 :

Code de retour Description
STATUS_INVALID_PARAMETER L’objet fichier fourni n’a pas de nom à remplacer.
STATUS_INSUFFICIENT_RESOURCES La mémoire insuffisante est disponible pour allouer une mémoire tampon pour effectuer cette opération.

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

Condition requise Valeur
Client minimal pris en charge Windows 7
Plateforme cible Universal
En-tête ntifs.h (inclure Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL