На главную

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 | Скачать Вниз

CopyProgressRoutine



[New - Windows NT]

The CopyProgressRoutine function is called when a portion of a copy operation started by CopyFileEx is completed. This function is an application-defined callback routine.

DWORD WINAPI CopyProgressRoutine(

LARGE_INTEGER TotalFileSize, // total file size, in bytes
LARGE_INTEGER TotalBytesTransferred, // total number of bytes transferred
LARGE_INTEGER StreamSize, // total number of bytes for this stream
LARGE_INTEGER StreamBytesTransferred, // total number of bytes transferred for this stream
DWORD dwStreamNumber, // the current stream
DWORD dwCallbackReason, // reason for callback
HANDLE hSourceFile, // handle to the source file
HANDLE hDestinationFile, // handle to the destination file
LPVOID lpData // passed by CopyFileEx
);


Parameters

TotalFileSize

The total size of the file, in bytes.

TotalBytesTransferred

The total number of bytes transferred from the source file to the destination file since the copy operation began.

StreamSize

The total size of the current file stream, in bytes.

StreamBytesTransferred

The total number of bytes in the current stream that have been transferred from the source file to the destination file since the copy operation began.

dwStreamNumber

Identifies the current stream. The stream number is 1 the first time CopyProgressRoutine is called.

dwCallbackReason

Specifies the reason that CopyProgressRoutine was called. This parameter can be one of the following values:

Value Meaning
CALLBACK_CHUNK_FINISHED Another part of the data file was copied.
CALLBACK_STREAM_SWITCH Another stream was created and is about to be copied. This is the callback reason given when the callback routine is first invoked.


hSourceFile

Identifies the source file.

hDestinationFile

Identifies the destination file

lpData

The argument passed to CopyProgressRoutine by the CopyFileEx function.



Return values

The CopyProgressRoutine function should return one of the following values:

Value Meaning
PROGRESS_CONTINUE Continue the copy operation.
PROGRESS_CANCEL Cancel the copy operation and delete the destination file.
PROGRESS_STOP Stop the copy operation. It can be restarted at a later time.
PROGRESS_QUIET Continue the copy operation, but stop invoking CopyProgressRoutine to report progress.


Remarks

An application can use this information to display a progress bar that shows the total number of bytes copied as a percent of the total file size.

See Also

CopyFileEx


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

CopyProgressRoutine



[Новый - Windows NT]

Функция CopyProgressRoutine названа когда часть действия копии начатой CopyFileEx завершена. Эта функция является определенной прикладной программой возврата.

DWORD WINAPI CopyProgressRoutine(

LARGE_INTEGER TotalFileSize, // общий файловый размер, в байтах LARGE_INTEGER TotalBytesTransferred, // общее число байтов передавало LARGE_INTEGER StreamSize, // общее число байтов для этого потока LARGE_INTEGER StreamBytesTransferred, // общее число байтов переводилось для этого потока DWORD dwStreamNumber, // текущий поток DWORD dwCallbackReason, // причина РУЧКИ возврата hSourceFile, // ручка в исходную файловую РУЧКУ hDestinationFile, // ручка в файл расположения LPVOID lpData // пройденный CopyFileEx
);


Параметры

TotalFileSize

Общий размер файла, в байтах.

TotalBytesTransferred

Общее число байтов переводилось от исходного файла до файла расположения с тех пор как действие копии начиналось.

StreamSize

Общий размер текущего файлового потока, в байтах.

StreamBytesTransferred

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

dwStreamNumber

Идентифицирует текущий поток. Номер потока - 1 сначала CopyProgressRoutine назван.

dwCallbackReason

Определяет причину того, что CopyProgressRoutine был назван. Этот параметр может быть одним из следующего величин:

Значение Величины
CALLBACK_CHUNK_FINISHED Другой части файла данных была скопирована.
CALLBACK_STREAM_SWITCH Другого потока был создан и собрался быть скопирован. Это - причина возврата данная когда программа возврата сначала введена.


hSourceFile

Идентифицирует исходный файл.

hDestinationFile

Идентифицирует файл расположения

lpData

Аргумент проходил на CopyProgressRoutine функцией CopyFileEx.



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

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

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


Замечания

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

Смотри Также

CopyFileEx


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