CopyProgressRoutine

Функция CopyProgressRoutine – это определяемая приложением функция обратного вызова, используемая функциями CopyFileEx и MoveFileWithProgress. Она вызывается тогда, когда часть операции копирования или перемещения завершена. Тип LPPROGRESS_ROUTINE определяет адрес к этой функции обратного вызова. CopyProgressRoutine – это зарезервированное имя для определяемой приложением функции обратного вызова.

DWORD CALLBACK CopyProgressRoutine(
  LARGE_INTEGER TotalFileSize,
  LARGE_INTEGER TotalBytesTransferred,
  LARGE_INTEGER StreamSize,
  LARGE_INTEGER StreamBytesTransferred,
  DWORD dwStreamNumber,
  DWORD dwCallbackReason,
  HANDLE hSourceFile,
  HANDLE hDestinationFile,
  LPVOID lpData
);

Параметры:

TotalFileSize	Конечный размер файла, в байтах.
TotalBytesTransferred	Конечное количество байт, переданных от файла-источника к файлу-назначения, начиная от начала операции копирования.
StreamSize	Конечный размер текущего файлового потока, в байтах.
StreamBytesTransferred	Конечное количество байт в текущем потоку, которые были переданы от файла-источника к файлу-назначения, начиная от начала операции копирования.
dwStreamNumber	Дескриптор текущего потока. При первом вызове CopyProgressRoutine, поток имеет номер 1.
dwCallbackReason	Причина, пот которой была вызвана CopyProgressRoutine. Этот параметр может принимать одно из следующих значений: CALLBACK_CHUNK_FINISHED - была скопирована другая часть данных файла. CALLBACK_STREAM_SWITCH - Был создан другой поток и он в копировании. Это причиняется обратным вызовом, когда обратный вызов был вызван первый раз.
hSourceFile	Дескриптор файла-источника.
hDestinationFile	Дескриптор файла-назначения.
lpData	Аргумент, переданный CopyProgressRoutine от функции CopyFileEx или MoveFileWithProgress.

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

Функция CopyProgressRoutine может возвращать одно из слудующих значений:

Значение:	Описание:
PROGRESS_CONTINUE	Продолжение операции копирования.
PROGRESS_CANCEL	Завершение операции копирования и удаление файла-назначения.
PROGRESS_STOP	Останов операции копирования. Она может быть перезапущена позже.
PROGRESS_QUIET	Продолжение операции копирования, но останов вызова CopyProgressRoutine для отчета о прогрессе.

Замечания:

Приложение может использовать эту функцию для отображения в своем окне процентного соотношения скопированных байт.

Смотрите также:

CopyFileEx, MoveFileWithProgress