API函数MoveFileEx使用详解(delphi)

前端之家收集整理的这篇文章主要介绍了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/733462.html

猜你在找的Delphi相关文章