IXtfCopyFileCallback::OnFileCopyProgress 메서드
파일 복사의 진행 상태가 변경될 때 호출됩니다.
구문
public:
HRESULT OnFileCopyProgress(
LPCWSTR pszSrcFileName,
LPCWSTR pszDstFileName,
ULONGLONG ullFileSize,
ULONGLONG ullBytesCopied
)
매개 변수
pszSrcFileName
형식: LPCWSTR
원본 파일의 파일 이름에 대한 포인터입니다. 이 매개 변수는 더 이상 사용되지 않으며 해당 값은 이제 pszDstFileName의 복사본입니다.
pszDstFileName
형식: LPCWSTR
대상 파일의 파일 이름에 대한 포인터입니다.
ullFileSize
형식: ULONGLONG
원본 파일의 전체 크기(바이트)입니다.
ullBytesCopied
형식: ULONGLONG
지금까지 복사된 파일의 바이트 수입니다.
반환 값
형식: HRESULT
성공한 경우 S_OK
을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 함수는 파일 복사 작업 중에 전송되는 각 패킷에 대해 IXtfFileIOClient::CopyFiles 메서드에서 호출됩니다. 파일에 대한 IXtfCopyFileCallback::OnFileCopyProgress 최초 호출은 ullBytesCopied
에서 0바이트와 ullFileSize
에서 MAX_FILE_SIZE 바이트를 지정합니다. 최초 호출은 새 파일 복사를 시작했음을 표시합니다. 그런 다음 XtfCopyFileCallback::OnFileCopyProgress 호출에 지정된 파일 정보를 사용하여 파일 복사 작업 중에 진행 상황을 추적하고 표시할 수 있습니다. 이 콜백 함수에서 HRESULT 오류 코드를 반환하면 파일 복사 작업이 중단됩니다.
요건
헤더: xtffileio.h
라이브러리: xtffileio.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)