MoveFileExA 関数 (winbase.h)

さまざまな移動オプションを使用して、既存のファイルまたはディレクトリ (子を含む) を移動します。

MoveFileWithProgress 関数は、MoveFileEx 関数と同じですが、moveFileWithProgress では進行状況通知を受け取るコールバック関数を提供できます。

この操作をトランザクション操作として実行するには、MoveFileTransacted 関数を使用します。

構文

BOOL MoveFileExA(
  [in]           LPCSTR lpExistingFileName,
  [in, optional] LPCSTR lpNewFileName,
  [in]           DWORD  dwFlags
);

パラメーター

[in] lpExistingFileName

ローカル コンピューター上のファイルまたはディレクトリの現在の名前。

dwFlags MOVEFILE_DELAY_UNTIL_REBOOTを指定した場合、遅延操作はネットワークを使用できるようになる前に実行されるため、リモート共有にファイルを存在できません。

既定では、名前はMAX_PATH文字に制限されています。 この制限を 32,767 文字のワイド文字に拡張するには、パスの先頭に "\\?\" を付けます。 詳細については、「ファイル、パス、および名前空間の名前付けする」を参照してください。

[in, optional] lpNewFileName

ローカル コンピューター上のファイルまたはディレクトリの新しい名前。

ファイルを移動する場合、コピー先は別のファイル システムまたはボリューム上に配置できます。 移動先が別のドライブにある場合は、dwFlagsで MOVEFILE_COPY_ALLOWED フラグ 設定する必要があります。

ディレクトリを移動する場合、移動先は同じドライブ上にある必要があります。

dwFlags が MOVEFILE_DELAY_UNTIL_REBOOT を指定し、lpNewFileName が NULL場合 、MoveFileEx は、システムの再起動時に削除する lpExistingFileName ファイルを登録します。 lpExistingFileName がディレクトリを参照している場合、システムは、ディレクトリが空の場合にのみ、再起動時にディレクトリを削除します。

既定では、名前はMAX_PATH文字に制限されています。 この制限を 32,767 文字のワイド文字に拡張するには、パスの先頭に "\\?\" を付けます。 詳細については、「ファイル、パス、および名前空間の名前付けする」を参照してください。

[in] dwFlags

このパラメーターには、次の値のうち 1 つ以上を指定できます。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値はゼロ (0) になります。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

dwFlags パラメーターで MOVEFILE_DELAY_UNTIL_REBOOTが指定されている場合、レジストリにアクセスできない場合、MoveFileEx 失敗します。 この関数は、再起動時に名前を変更するファイルの場所を次のレジストリ値に格納します。system HKEY_LOCAL_MACHINE\\CurrentControlSet\Control\Session Manager\PendingFileRenameOperations

このレジストリ値の型は REG_MULTI_SZです。 各名前変更操作には、名前の変更が削除であるかどうかに応じて、次の NULL で終わる文字列のいずれかが格納されます。

• szSrcFile\0\0
• szSrcFile\0szDstFile\0

MoveFileEx(szSrcFile, NULL, MOVEFILE_DELAY_UNTIL_REBOOT);
MoveFileEx(szSrcFile, szDstFile, MOVEFILE_DELAY_UNTIL_REBOOT);