Функция MoveFile перемещает существующий файл или каталог, включая его дочерние элементы.
Чтобы определить, каким образом переместить файл, используйте функцию MoveFileEx.
Синтаксис
BOOL MoveFile( LPCTSTR lpExistingFileName, // имя файла LPCTSTR lpNewFileName // имя нового файла ); |
lpExistingFileName
[in] Указатель на символьную строку с нулем в конце, которая именует существующий файл или каталог.Windows NT/2000/XP: В версии ANSI этой функции, имя ограничивается числом символов флажка MAX_PATH. Чтобы выйти за пределы этого ограничения, до длины 32 767 символов, вызовите Unicode версию этой функции и присоедините спереди пути "\\?\". Подробную информацию см. в статье Именование файлов.
Windows 95/98/Me: Эта символьная строка не должна выходить за пределы количества символов флажка MAX_PATH.
lpNewFileName
[in] Указатель на символьную строку с нулем в конце, которая определяет новое имя файла или каталога. Новое имя не должно ранее существовать. Новый файл может быть другой файловой системы или на другом диске. Новый каталог должен быть на одном и том же диске.Windows NT/2000/XP: В версии ANSI этой функции, имя ограничивается количеством символов флажка MAX_PATH. Чтобы выйти за пределы этого ограничения, до длины 32 767 символов, вызовите Unicode версию этой функции и присоедините спереди пути "\\?\". Подробную информацию см. в статье Именование файлов.
Windows 95/98/Me: Эта символьная строка не должна выходить за пределы количества символов флажка MAX_PATH.
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Функция MoveFile перемещает (переименовывает) или файл или каталог (включая его дочерние элементы), или в том же самом каталоге, или во всех каталогах. Первым предупреждением является то, что функция MoveFile завершится ошибкой при перемещении каталога, когда место назначения является другим томом.
Если файл перемещается, между томами, функция MoveFile не перемещает дескриптор безопасности с файлом. Файлу должен быть назначен заданный по умолчанию дескриптор безопасности в принимающем каталоге.
Функция MoveFile координирует свою операцию со службой отслеживания связей, так что исходная связь может прослеживаться, когда файл перемещается.
Смотри также
Обзор Управление файлами, Функции, используемые в управлении файлами, CopyFile, MoveFileEx, MoveFileWithProgress
|
Размещение и совместимость MoveFile |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
| т |
Windows 95 |
Да |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Реализуется как версии Unicode и ANSI для Windows 2000/XP. Обратите внимание на то, что поддержка в Windows Me/98/95 требует программы Microsoft Layer for Unicode. |
|
| Замечания по платформе |
Не имеется |
|