让我吃亏的 API MoveFileEx

本文主要是介绍让我吃亏的 API MoveFileEx，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

转载：

{ 函数原型 }

function MoveFileEx(
lpExistingFileName: PChar; // 来源文件名，指向一个以零结尾的字符串的指针。
lpNewFileName: PChar;       // 目标文件名，指向一个以零结尾的字符串的指针。
dwFlags: DWORD              // 移动标记，见定义
): BOOL; stdcall;           // 返回执行结果，成果或失败

{ dwFlags的值 }

MOVEFILE_REPLACE_EXISTING = $00000001; // 覆盖已存在的目标文件，如果来源文件和目标文件指定的是一个目录，则不能使用此标记。

MOVEFILE_COPY_ALLOWED = $00000002; // 如果目标文件被移动到不同的卷上，则函数通过拷贝后删除来源文件的方法来模拟移动文件操作。

MOVEFILE_DELAY_UNTIL_REBOOT = $00000004; // 在系统重新启动前，不执行移动操作，直到系统启动后，磁盘检测完毕后，创建页面文件之前，执行移动操作。因此，这个参数可以删除系统之前启用的页面文件。这个参数只能被拥有管理员权限或 LocalSystem权限的程序使用。这个参数不能和 MOVEFILE_COPY_ALLOWED 一起使用。

MOVEFILE_WRITE_THROUGH = $00000008; // 这个标记允许函数在执行完文件移动操作后才返回，否者不等文件移动完毕就直接返回。如果设置了 MOVEFILE_DELAY_UNTIL_REBOOT 标记，则 MOVEFILE_WRITE_THROUGH 标记将被忽略。

MOVEFILE_CREATE_HARDLINK = $00000010; // 系统保留，以供将来使用

MOVEFILE_FAIL_IF_NOT_TRACKABLE = $00000020; // 如果来源文件是一个 LINK 文件，但是文件在移动后不能够被 TRACKED，则函数执行失败。如果目标文件在一个 FAT 格式的文件系统上，则上述情况可以发生。这个参数不支持 NT 系统。(我想这里说的可能是移动快捷方式的情况，如果快捷方式指定的目标文件不存在或无法定位，则操作失败，由于没有时间测试，暂时这样理解。)

{ 说明 }

MoveFileEx 用来移动一个现有的文件或目录

MoveFileWithProgress 功能与 MoveFileEx 是相同的，只不过 MoveFileWithProgress 允许你提供一个接收移动进度消息的回调函数。

MoveFileEx 函数在 ANSI 版本中，文件名长度被限制在 MAX_PATH 个字符内，为了将这个这个限制扩展到 32767 个宽字符长度，请使用 UNICODE 版本的函数，并且使用“//?/”作为路径前缀。

在 WINDOWS 20000 中，如果你使用了“//?/”前缀，则不能使用 MOVEFILE_DELAY_UNTIL_REBOOT 标记。

当你移动一个文件时，目标文件和来源文件可能在不同文件系统或卷上，如果目标文件在其他驱动器上，你必须指定 MOVEFILE_COPY_ALLOWED 标记。

如果移动的是一个目录，则目标目录必须和来源目录在同一个驱动器上。

如果指定了 MOVEFILE_DELAY_UNTIL_REBOOT 标记，而且目标文件指定为空路径，则来源文件将在系统启动时被删除。如果来源文件指定的是一个空目录，则来源目录将在系统启动时被删除，如果是非空目录，则无法删除。

如果此函数设置了 MOVEFILE_DELAY_UNTIL_REBOOT 标记，而又无法存取注册表项，则函数将执行失败。MoveFileEx 函数在系统启动时移动文件的操作被存储在注册表的以下位置：

[HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Control/Session Manager]
PendingFileRenameOperations=hex(7):

这个注册表值是 REG_MULTI_SZ 类型，每个移动操作都被存储在一对 NULL 结尾的字符串中。例如：

szDstFile/0/0
szSrcFile/0szDstFile/0/0

系统通过这些注册表数据来实现在系统启动时移动文件，移动的顺序是按照注册表中写入的顺序执行。

如果函数指定了 MOVEFILE_DELAY_UNTIL_REBOOT 标记，则函数的返回值就不能正确表示函数执行成功与否，因为移动操作是在系统启动时才会被执行，最好的办法就是把执行结果记录在注册表中。

函数在 MOVEFILE_DELAY_UNTIL_REBOOT 标记中只能删除空目录，如果你要删除非空目录，则必须确保在执行删除目录操作前，将目录内的文件或子目录全部清空。如果目录内的文件只有在启动时才能被删除，则必须把删除目录内文件的操作放在删除目录操作之前。因为系统是根据 PendingFileRenameOperations 注册表值中记录的顺序来执行移动、删除操作的。

PendingFileRenameOperations 注册表值中记录的操作顺序和程序调用 MoveFileEx 函数的顺序是一样的。

如果一个文件跨卷移动，则函数不移动文件的安全属性，文件将被赋予目标目录所定义的默认安全属性。

MoveFileEx 函数配合链接跟踪服务来完成操作。因此，当来源文件被复制时，他们的目标文件可以被跟踪。(我想这里说的也是移动快捷方式，不是太懂)

Windows ME/98/95 不支持 MoveFileEx 函数，如果要在启动时移动或删除文件，请在 WinInit.ini 中操作。

如果 WinInit.ini 不存在，则创建此文件，然后在其中加入 [rename] 段，后在 [rename] 段中加入如下格式的行：

DestinationFileName=SourceFileName

DestinationFileName 和 SourceFileName 必须使用短文件名，如果要删除文件，请将 DestinationFileName 置空：

=SourceFileName

遇到的问题1：在MoveFileEx成功后读文件出错，错误：打开文件被拒绝，这个文件被别的处理使用了。

解决方法1：MOVEFILE_WRITE_THROUGH的Flag没有设置

理解：自己的理解，不设置的话貌似函数是非同期的，只要要求被传递给操作系统后就返回成功了，

剩下的就是操作系统自己完成真正的移动工作了。好处就不说了（非同期）。