MoveFileEx

VB声明

Declare Function MoveFile& Lib "kernel32" Alias "MoveFileA" (ByVal lpExistingFileName As String, ByVal lpNewFileName As String)

Declare Function MoveFileEx& Lib "kernel32" Alias "MoveFileExA" (ByVal lpExistingFileName As String, ByVal lpNewFileName As String, ByVal dwFlags As Long)

说明

移动文件。如dwFlags设为零，则MoveFileEx完全等价于MoveFile

返回值

Long，非零表示成功，零表示失败。会设置GetLastError

参数表

参数 类型及说明

lpExistingFileName String，欲移动的文件名

lpNewFileName String，新文件名

dwFlags Long，一个或多个下述常数

MOVEFILE_REPLACE_EXISTING 如目标文件存在，则将其替换

MOVEFILE_COPY_ALLOWED 如移动到一个不同的卷，则复制文件并删除原来的文件

MOVEFILE_DELAY_UNTIL_REBOOT 移动操作在系统下次重新启动时正式进行。这样便可在Windows NT中改换系统文件

注解

这两个函数通常不能将文件从一个卷移动到另一个卷。但如设置了MOVEFILE_COPY_ALLOWED标记，MoveFileEx可以做到这一点

当参数dwFlags为MOVEFILE_DELAY_UNTIL_REBOOT时，移动文件的操作在系统下次重新启动时才进行，MoveFileEx进行的操作只是把要移动的文件的信息写入注册表项HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Control\\SessionManager\\PendingFileRenameOperations下。函数的返回值只反映写入注册表的操作是否成功。

VC声明

函数原型：

BOOL MoveFileEx(

LPCTSTR lpExistingFileName, // file name

LPCTSTR lpNewFileName, // new file name

DWORD dwFlags // move options

);

参数说明：

lpExistingFileName，一个存在的文件或者文件夹字符串指针

lpNewFileName ，一个还没存在的文件或者文件夹的字符串指针

dwFlags ,一个或多个下述常数：

MOVEFILE_COPY_ALLOWED

如移动到一个不同的卷，则复制文件并删除原来的文件。

MOVEFILE_CREATE_HARDLINK

系统保留，以供将来使用。

MOVEFILE_DELAY_UNTIL_REBOOT

移动操作在系统下次重新启动时正式进行。

MOVEFILE_FAIL_IF_NOT_TRACKABLE

如果来源文件是一个 LINK 文件，但是文件在移动后不能够被 TRACKED，则函数执行失

败。如果目标文件在一个 FAT 格式的文件系统上，则上述情况可以发生。这个参数不支持

NT 系统。(我想这里说的可能是移动快捷方式的情况，如果快捷方式指定的目标文件不存在

或无法定位，则操作失败，由于没有时间测试，暂时这样理解。)

MOVEFILE_REPLACE_EXISTING

如目标文件存在，则将其替换 。

MOVEFILE_WRITE_THROUGH

这个标记允许函数在执行完文件移动操作后才返回，否者不等文件移动完毕就直接返回

。如果设置了 MOVEFILE_DELAY_UNTIL_REBOOT 标记，则 MOVEFILE_WRITE_THROUGH 标记将

被忽略。