API函数MoveFileEx使用详解(delphi)

API原型:
Declare Function MoveFileEx& Lib "kernel32" Alias "MoveFileExA" (ByVal lpExistingFileName As String,ByVal lpNewFileName As String,ByVal dwFlags As Long)
参数 类型及说明 
lpExistingFileName String,欲移动的文件名 
lpNewFileName String,新文件名 
dwFlags Long,一个或多个下述常数 
MOVEFILE_REPLACE_EXISTING 如目标文件存在,则将其替换 
MOVEFILE_COPY_ALLOWED 如移动到一个不同的卷,则复制文件并删除原来的文件 
MOVEFILE_DELAY_UNTIL_REBOOT 移动操作在系统下次重新启动时正式进行。这样便可在WindowsNT中改换系统文件



 
 
{ 函数原型 }
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

相关文章

 从网上看到《Delphi API HOOK完全说明》这篇文章,基本上都...
  从网上看到《Delphi API HOOK完全说明》这篇文章,基本上...
ffmpeg 是一套强大的开源的多媒体库 一般都是用 c/c+&#x...
32位CPU所含有的寄存器有:4个数据寄存器(EAX、EBX、ECX和ED...
1 mov dst, src dst是目的操作数,src是源操作数,指令实现的...