API函数MoveFileEx使用详解

{ 函数原型 }

BOOL 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