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;
Miembros
DUMMYUNIONNAME
DUMMYUNIONNAME.ReplaceIfExists
Este campo se usa cuando el parámetro FileInformationByHandle de FileInformationClass 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 de FileInformationClass se establece en FileRenameInfoEx.
ReplaceIfExists
RootDirectory
Este campo debe establecerse en NULL.
FileNameLength
Tamaño de FileName en bytes, no incluida la terminación NUL.
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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | winbase.h (incluya Windows.h) |
| Redistribuible | Windows SDK en Windows Server 2003 y Windows XP. |