FILE_RENAME_INFO構造体 (winbase.h)

ソース ファイルの名前を変更するターゲット名を格納します。 SetFileInformationByHandle を呼び出す場合にのみ使用します。

構文

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;

メンバー

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

このフィールドは、 SetFileInformationByHandle の FileInformationClass パラメーターが FileRenameInfo に設定されている場合に使用されます。 このフィールドが TRUE で 、ターゲット ファイルが存在する場合、ターゲット ファイルはソース ファイルに置き換えられます。 このフィールドが FALSE で、ターゲット ファイルが存在する場合、操作はエラーを返します。

DUMMYUNIONNAME.Flags

このフィールドは、 SetFileInformationByHandle の FileInformationClass パラメーターが FileRenameInfoEx に設定されている場合に使用されます。

ReplaceIfExists

RootDirectory

このフィールドは NULL に設定する必要があります。

FileNameLength

NUL 終了を含まない FileName のサイズ (バイト単位)。

FileName[1]

ファイルへの新しいパスを含む NUL で終わるワイド文字列。 値は次のいずれかになります。

• 絶対パス (ドライブ、ディレクトリ、ファイル名)。
• プロセスの現在のディレクトリに対する相対パス。
• NTFS ファイル ストリームの新しい名前 (以降 :)。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	winbase.h (Windows.h を含む)
再頒布可能パッケージ	Windows Server 2003 および Windows XP でWindows SDK。

こちらもご覧ください

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle