estructura FILE_RENAME_INFO (winbase.h)

Contiene el nombre de destino al que se debe cambiar el nombre del archivo de origen. Use solo al llamar a SetFileInformationByHandle.

Sintaxis

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;

Members

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

Este campo se usa cuando el parámetro FileInformationByHandle fileInformationClass de SetFileInformation se establece en FileRenameInfo. Si este campo es TRUE y el archivo de destino existe, el archivo de destino se reemplazará por el archivo de origen. Si este campo es FALSE y el archivo de destino existe, la operación devolverá un error.

DUMMYUNIONNAME.Flags

Este campo se usa cuando el parámetro FileInformationByHandle fileInformationClass de SetFileInformation se establece en FileRenameInfoEx.

ReplaceIfExists

RootDirectory

Establezca en NULL en el caso común. Si FileName especifica un nombre relativo, este campo puede ser un identificador del directorio en relación con el que se resuelve el nuevo nombre.

FileNameLength

Tamaño de FileName en bytes. No se requiere un carácter nulo de terminación.

FileName[1]

Cadena de caracteres anchos terminada en NUL que contiene la nueva ruta de acceso al archivo. El valor puede ser uno de los siguientes:

• Ruta de acceso absoluta (unidad, directorio y nombre de archivo).
• Ruta de acceso relativa al directorio actual del proceso.
• Nuevo nombre de una secuencia de archivos NTFS, empezando por :.

Requisitos

Consulte también

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle