IoReplaceFileObjectName, fonction (ntifs.h)

Article
02/07/2025

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 remplacé.

[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 de fichier.

Valeur de retour

Retourne STATUS_SUCCESS ou l’une des valeurs NTSTATUS suivantes dans le cas contraire :

Retourner le code	Description
STATUS_INVALID_PARAMETER	L’objet de 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 fichier. Le remplacement d’un nom d’objet de fichier directement sans utiliser IoReplaceFileObjectName peut entrer en conflit avec d’autres utilisations du nom et doit être évité si 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Partager via