На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

CopyFileEx



[New - Windows NT]

The CopyFileEx function copies an existing file to a new file. This function preserves extended attributes, OLE structured storage, NTFS alternate data streams, and file attributes. Security attributes for the existing file are not copied to the new file.

BOOL CopyFileEx(

LPCWSTR lpExistingFileName, // pointer to name of an existing file
LPCWSTR lpNewFileName, // pointer to filename to copy to
LPPROGRESS_ROUTINE lpProgressRoutine, // pointer to the callback function
LPVOID lpData, // to be passed to the callback function
LPBOOL pbCancel, // flag that can be used to cancel the operation
DWORD dwCopyFlags // flags that specify how the file is copied
);


Parameters

lpExistingFileName

Points to a null-terminated string that specifies the name of an existing file.

lpNewFileName

Points to a null-terminated string that specifies the name of the new file.

lpProgressRoutine

Specifies the address of a callback function of type LPPROGRESS_ROUTINE that is called each time another portion of the file has been copied. This parameter can be NULL. For more information on the progress callback function, see CopyProgressRoutine.

lpData

Specifies an argument to be passed to the callback function. This parameter can be NULL.

pbCancel

Points to a Boolean variable that can be used to cancel the operation. If this flag is set to TRUE during the copy operation, the operation is canceled.

dwCopyFlags

Specifies how the file is to be copied. This parameter can be a combination of the following values:

Value Meaning
COPY_FILE_FAIL_IF_EXISTS The copy operation fails immediately if the target file already exists.
COPY_FILE_RESTARTABLE Progress of the copy is tracked in the target file in case the copy fails. The failed copy can be restarted at a later time by specifying the same values for lpExistingFileName and lpNewFileName as those used in the call that failed.


Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information call GetLastError.

Remarks

For information on file attributes, see CreateFile.

See Also

CreateFile, CopyFile, CopyProgressRoutine, MoveFile


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

CopyFileEx



[Новый - Windows NT]

Функция CopyFileEx копирует существующий файл в новый файл. Эта функция сохраняет расширенные атрибуты, структурную память OLE, альтернативные потоки данных NTFS, и атрибутов файла. Атрибуты Безопасности для существующего файла не скопированы в новый файл.

BOOL CopyFileEx(

LPCWSTR lpExistingFileName, // УКАЗАТЕЛЬ в имя существующего файла LPCWSTR lpNewFileName, // указателя, чтобы filename, чтобы копироваться на LPPROGRESS_ROUTINE lpProgressRoutine, // указатель в функцию возврата LPVOID lpData, //, чтобы быть пройденн в функцию возврата LPBOOL pbCancel, // флаг, что может быть использовано, чтобы отменять флаги операции DWORD dwCopyFlags //, которые определяют как файл скопирован
);


Параметры

lpExistingFileName

Точки на недействительный расторгнутую строку, которые определяют имя существующего файла.

lpNewFileName

Точки на недействительный расторгнутую строку, которые определяют имя нового файла.

lpProgressRoutine

Определяет адрес функции возврата типа LPPROGRESS_ROUTINE, который назван всякий раз, когда другая часть файла скопирована. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН. Более подробно в функции возврата прогресса, смотри CopyProgressRoutine.

lpData

Определяет аргумент, который нужно проходить в функцию возврата. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

pbCancel

Точки на Логическую переменную, которые могут быть использованы, чтобы отменять операцию. Если этот флаг установлен в ИСТИНУ в течение операции копии, операция отменена.

dwCopyFlags

Определяет как файл должен быть скопирован. Этот параметр может быть комбинацией следующего величин:

Значение Величины
COPY_FILE_FAIL_IF_EXISTS операция копии терпит неудачу немедленно если целевой файл уже существует.
Прогресс COPY_FILE_RESTARTABLE копии прослежен в целевом файле в случае, если копия терпит неудачу. Неудачная копия может перезапускаться впоследствии определяя те же величины для lpExistingFileName и lpNewFileName как те использованные на вызове, что терпел неудачу.


Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Чтобы расширять информационный вызов ошибки GetLastError.

Замечания

Для информации об атрибутах файла, смотри CreateFile.

Смотри Также

CreateFile, CopyFile, CopyProgressRoutine, MoveFile


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz