struttura FILE_RENAME_INFO (winbase.h)

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;

Membri

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

Questo campo viene utilizzato 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

Impostare su NULL nel caso comune. Se FileName specifica un nome relativo, questo campo può essere un handle per la directory relativa alla quale viene risolto il nuovo nome.

FileNameLength

Dimensioni di FileName in byte. Non è necessario un carattere Null di terminazione.

FileName[1]

Stringa di caratteri wide con terminazione NUL contenente il nuovo percorso del file. Il valore può essere uno dei 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

Vedere anche

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle