struttura FILE_RENAME_INFO (winbase.h)

  • Articolo

Contiene il nome di destinazione in cui deve essere rinominato il file di origine. Usare solo quando si chiama SetFileInformationByHandle.

Sintassi

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

Questo campo viene usato quando il parametro FileInformationByHandle di SetFileInformationClass è impostato su FileRenameInfo. Se questo campo è TRUE e il file di destinazione esiste, il file di destinazione verrà sostituito dal file di origine. Se questo campo è FALSE e il file di destinazione esiste, l'operazione restituirà un errore.

DUMMYUNIONNAME.Flags

Questo campo viene usato quando il parametro FileInformationByHandle di SetFileInformationClass è impostato su FileRenameInfoEx.

ReplaceIfExists

RootDirectory

Questo campo deve essere impostato su NULL.

FileNameLength

Dimensione di FileName in byte, non inclusa la terminazione NUL.

FileName[1]

Stringa di caratteri wide con terminazione NUL contenente il nuovo percorso del file. I possibili valori sono i seguenti:

  • Percorso assoluto (unità, directory e nome file).
  • Percorso relativo alla directory corrente del processo.
  • Nuovo nome di un flusso di file NTFS, a partire da :.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione winbase.h (include Windows.h)
Componente ridistribuibile Windows SDK in Windows Server 2003 e Windows XP.

Vedi anche

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle