LPPROGRESS_ROUTINE 콜백 함수(winbase.h)
CopyFileEx, MoveFileTransacted 및 MoveFileWithProgress 함수와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 복사 또는 이동 작업의 일부가 완료되면 호출됩니다. LPPROGRESS_ROUTINE 형식은 이 콜백 함수에 대한 포인터를 정의합니다. CopyProgressRoutine 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.
구문
LPPROGRESS_ROUTINE LpprogressRoutine;
DWORD LpprogressRoutine(
[in] LARGE_INTEGER TotalFileSize,
[in] LARGE_INTEGER TotalBytesTransferred,
[in] LARGE_INTEGER StreamSize,
[in] LARGE_INTEGER StreamBytesTransferred,
[in] DWORD dwStreamNumber,
[in] DWORD dwCallbackReason,
[in] HANDLE hSourceFile,
[in] HANDLE hDestinationFile,
[in, optional] LPVOID lpData
)
{...}
매개 변수
[in] TotalFileSize
파일의 총 크기(바이트)입니다.
[in] TotalBytesTransferred
복사 작업이 시작된 이후 원본 파일에서 대상 파일로 전송된 총 바이트 수입니다.
[in] StreamSize
현재 파일 스트림의 총 크기(바이트)입니다.
[in] StreamBytesTransferred
복사 작업이 시작된 이후 원본 파일에서 대상 파일로 전송된 현재 스트림의 총 바이트 수입니다.
[in] dwStreamNumber
현재 스트림에 대한 핸들입니다. CopyProgressRoutine이 처음 호출되면 스트림 번호는 1입니다.
[in] dwCallbackReason
CopyProgressRoutine이 호출된 이유입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
데이터 파일의 다른 부분이 복사되었습니다. |
|
다른 스트림이 만들어지고 복사하려고 합니다. 콜백 루틴이 처음 호출될 때 지정된 콜백 이유입니다. |
[in] hSourceFile
원본 파일에 대한 핸들입니다.
[in] hDestinationFile
대상 파일에 대한 핸들
[in, optional] lpData
CopyFileEx, MoveFileTransacted 또는 MoveFileWithProgress에 의해 CopyProgressRoutine에 전달된 인수입니다.
반환 값
CopyProgressRoutine 함수는 다음 값 중 하나를 반환해야 합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
복사 작업을 취소하고 대상 파일을 삭제합니다. |
|
복사 작업을 계속합니다. |
|
복사 작업을 계속하지만 CopyProgressRoutine 호출을 중지하여 진행 상황을 보고합니다. |
|
복사 작업을 중지합니다. 나중에 다시 시작할 수 있습니다. |
설명
애플리케이션은 이 정보를 사용하여 총 파일 크기의 백분율로 복사된 총 바이트 수를 보여 주는 진행률 표시줄을 표시할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |