Отправляет email-рассылки с помощью сервиса Sendsay

WinAPI на русском

  Все выпуски  

WinAPI на русском


Информационный Канал Subscribe.Ru

Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".

Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.

Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm

Обновления на сайте

Нет.

Перевод

Сегодня вашему вниманию представлен перевод функции MoveFile.

MoveFile

Функция MoveFile перемещает существующий файл или существующую директорию, включая
поддиректории. Чтобы указать, как переместить файл, используйте функцию MoveFileEx.

BOOL MoveFile(
  LPCTSTR lpExistingFileName, // имя файла
  LPCTSTR lpNewFileName // новое имя файла
);

Параметры

lpExistingFileName – указатель на завершающуюся нулем строку, которая содержит
имя существующего файла или директории.
Windows NT/2000/XP: в ANSI-версии этой функции длина имени ограничена MAX_PATH
символами. Для расширения этого ограничения до почти 32,000 расширенных символов
вызовите Unicode-версию функции и предварите путь символами "\\?\". Для дополнительной
информации смотрите раздел "Именование файла" (Naming a File).
Windows 95/98/Me: строка не должна быть длиннее MAX_PATH символов.
lpNewFileName – указатель на завершающуюся нулем строку, которая содержит новое
имя файла или директории. Файл или директория с новым именем не обязательно должны
существовать. Новая директория должна быть на том же разделе диска, что и старая.
Windows NT/2000/XP: в ANSI-версии этой функции длина имени ограничена MAX_PATH
символами. Для расширения этого ограничения до почти 32,000 расширенных символов
вызовите Unicode-версию функции и предварите путь символами "\\?\". Для дополнительной
информации смотрите раздел "Именование файла" (Naming a File).
Windows 95/98/Me: строка не должна быть длиннее MAX_PATH символов.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации вызовите
функцию GetLastError.

Комментарии

Функция MoveFile будет перемещать (переименовывать) файл или директорию, включая
дочерние файлы и директории), либо в той же директории, либо через директории.
Единственный случай, когда вызов MoveFile завершится неудачей при перемещении
директории ? когда директория назначения находится на другом разделе диска.
Windows 2000/XP: функция MoveFile координирует свои действия со службой отслеживания
ссылок, так что источники ссылок могут быть отслежены при их перемещении.
Windows 95/98/Me: MoveFileW поддерживается через Microsoft Layer для Unicode.
Для его использования вы должны добавить некоторые файлы в ваше приложение, как
описано в "Microsoft Layer for Unicode on Windows 95/98/Me Systems".
В качестве примера смотрите "Создание и использование временного файла".

Требования

Windows NT/2000/XP: включена в Windows NT 3.1 и выше.
Windows 95/98/Me: включена в Windows 95 и выше.
Заголовок: объявлена в Winbase.h; подключать Windows.h.
Библиотека: используйте Kernel32.lib.
Unicode: реализована как версии Unicode и ANSI в Windows NT/2000/XP. Также поддерживается
через Microsoft Layer для Unicode.

См. также

CopyFile, MoveFileEx, MoveFileWithProgress.

хелп по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe

С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru


http://subscribe.ru/
E-mail: ask@subscribe.ru
Отписаться
Убрать рекламу

В избранное