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 |
); |
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. |
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. |
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.
file: /Techref/os/win/api/win32/func/src/f07_19.htm, 6KB, , updated: 2000/4/7 12:19, local time: 2024/9/2 11:21,
18.217.4.250:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://sxlist.com/Techref/os/win/api/win32/func/src/f07_19.htm"> CopyProgressRoutine</A> |
Did you find what you needed? |
Welcome to sxlist.com!sales, advertizing, & kind contributors just like you! Please don't rip/copy (here's why Copies of the site on CD are available at minimal cost. |
Welcome to sxlist.com! |
.