MoveFileTransactedA 関数 (winbase.h)

[Microsoft では、開発者がアプリケーションのニーズを達成するために代替手段を利用することを強くお勧めします。 TxF が開発された多くのシナリオは、よりシンプルで利用しやすい手法で実現できます。 また、将来のバージョンの Microsoft Windows では TxF を使用できない場合があります。 詳細、および TxF の代替手段については、「トランザクション NTFS の使用の代替手段」を参照してください。]

トランザクション操作として、既存のファイルまたはディレクトリ (その子を含む) を移動します。

構文

BOOL MoveFileTransactedA(
  [in]           LPCSTR             lpExistingFileName,
  [in, optional] LPCSTR             lpNewFileName,
  [in, optional] LPPROGRESS_ROUTINE lpProgressRoutine,
  [in, optional] LPVOID             lpData,
  [in]           DWORD              dwFlags,
  [in]           HANDLE             hTransaction
);

パラメーター

[in] lpExistingFileName

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

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

[in, optional] lpNewFileName

ファイルまたはディレクトリの新しい名前。 新しい名前が存在してはいけません。 新しいファイルは、別のファイル システムまたはドライブ上に配置できますが、 新しいディレクトリは同じドライブ上に配置する必要があります。

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

[in, optional] lpProgressRoutine

ファイルの別の部分が移動されるたびに呼び出される CopyProgressRoutine コールバック関数へのポインター。 コールバック関数は、操作の進行状況を表示するユーザー インターフェイスを提供する場合に役立ちます。 このパラメーターは、NULL でもかまいません。

[in, optional] lpData

CopyProgressRoutine コールバック関数に渡される引数。 このパラメーターは、NULL でもかまいません。

[in] dwFlags

移動オプション。 このパラメーターには、次の 1 つ以上の値を指定できます。

[in] hTransaction

トランザクションへのハンドル。 このハンドルは、 CreateTransaction 関数によって返されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

ボリューム間でファイルを移動するときに、ユーザーが操作を取り消したために lpProgressRoutine が PROGRESS_CANCEL を返した場合、 MoveFileTransacted は 0 を返し、 GetLastError は ERROR_REQUEST_ABORTEDを返します。 既存のファイルはそのまま残ります。

ボリューム間でファイルを移動するときに、ユーザーが操作を停止したために lpProgressRoutine が PROGRESS_STOP を返した場合、 MoveFileTransacted は 0 を返し、 GetLastError は ERROR_REQUEST_ABORTEDを返します。 既存のファイルはそのまま残ります。

注釈

dwFlags パラメーターでMOVEFILE_DELAY_UNTIL_REBOOTが指定されている場合、レジストリにアクセスできない場合、MoveFileTransacted は失敗します。 関数は、再起動時に名前を変更するファイルの場所を、次のレジストリ値にトランザクションによって格納します。system\CurrentControlSet\コントロール\セッション マネージャー\PendingFileRenameOperationsHKEY_LOCAL_MACHINE\

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

szDstFile\0\0

szSrcFile\0szDstFile\0

文字列 szDstFile\0\0 は、再起動時にファイル szDstFile が削除されることを示します。

文字列 szSrcFile\0szDstFile\0 は、再起動時に szSrcFile の名前を szDstFile に変更することを示します。

ファイルがボリューム間で移動された場合、 MoveFileTransacted はファイルを含むセキュリティ記述子を移動しません。 ファイルには、宛先ディレクトリの既定のセキュリティ記述子が割り当てられます。

MOVEFILE_FAIL_IF_NOT_TRACKABLE フラグを指定すると、この関数は常 に 失敗します。追跡は TxF ではサポートされていません。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

SMB 3.0 は TxF をサポートしていません。

要件

関連項目

CopyFileTransacted

File Management 関数

MoveFileWithProgress

トランザクション NTFS