structure FILE_RENAME_INFO (winbase.h)

Contient le nom cible auquel le fichier source doit être renommé. Utilisez uniquement lors de l’appel de SetFileInformationByHandle.

Syntaxe

typedef struct _FILE_RENAME_INFO {
  union {
    BOOLEAN ReplaceIfExists;
    DWORD   Flags;
  } DUMMYUNIONNAME;
  BOOLEAN ReplaceIfExists;
  HANDLE  RootDirectory;
  DWORD   FileNameLength;
  WCHAR   FileName[1];
} FILE_RENAME_INFO, *PFILE_RENAME_INFO;

Membres

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

Ce champ est utilisé lorsque le paramètre FileInformationClass de SetFileInformationByHandle est défini sur FileRenameInfo. Si ce champ a la valeur TRUE et que le fichier cible existe, le fichier cible est remplacé par le fichier source. Si ce champ a la valeur FALSE et que le fichier cible existe, l’opération retourne une erreur.

DUMMYUNIONNAME.Flags

Ce champ est utilisé lorsque le paramètre FileInformationClass de SetFileInformationByHandle est défini sur FileRenameInfoEx.

ReplaceIfExists

RootDirectory

Ce champ doit avoir la valeur NULL.

FileNameLength

Taille de FileName en octets, sans l’arrêt nul.

FileName[1]

Chaîne de caractères larges terminée par nul contenant le nouveau chemin d’accès au fichier. Il peut s'agir de l'une des valeurs suivantes :

• Chemin d’accès absolu (lecteur, répertoire et nom de fichier).
• Chemin d’accès relatif au répertoire actif du processus.
• Nouveau nom d’un flux de fichiers NTFS, à partir :de .

Configuration requise

Voir aussi

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle