estructura FILE_RENAME_INFO (winbase.h)

  • Artículo

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.

Consulte también

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle