FILE_RENAME_INFO Struktur (winbase.h)

Enthält den Zielnamen, in den die Quelldatei umbenannt werden soll. Wird nur beim Aufrufen von SetFileInformationByHandle verwendet.

Syntax

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;

Mitglieder

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

Dieses Feld wird verwendet, wenn der FileInformationClass-Parameter von SetFileInformationByHandle auf FileRenameInfo festgelegt ist. Wenn dieses Feld WAHR ist und die Zieldatei vorhanden ist, wird die Zieldatei durch die Quelldatei ersetzt. Wenn dieses Feld FALSCH ist und die Zieldatei vorhanden ist, gibt der Vorgang einen Fehler zurück.

DUMMYUNIONNAME.Flags

Dieses Feld wird verwendet, wenn der FileInformationClass-Parameter von SetFileInformationByHandle auf FileRenameInfoEx festgelegt ist.

ReplaceIfExists

RootDirectory

Wird im allgemeinen Fall auf NULL festgelegt. Wenn FileName einen relativen Namen angibt, kann es sich bei diesem Feld um ein Handle für das Verzeichnis relativ zu dem der neue Name aufgelöst wird.

FileNameLength

Die Größe von FileName in Byte. Es ist kein beendendes NULL-Zeichen erforderlich.

FileName[1]

Eine NUL-beendete Zeichenfolge mit breitem Zeichen, die den neuen Pfad zur Datei enthält. Folgende Werte sind möglich:

• Ein absoluter Pfad (Laufwerk, Verzeichnis und Dateiname).
• Ein Pfad relativ zum aktuellen Verzeichnis des Prozesses.
• Der neue Name eines NTFS-Dateistreams, beginnend mit :.

Requirements

Siehe auch

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle-