Skip to main content

IXtfCopyFileCallback::OnFileCopyProgress 메서드

파일 복사 진행률이 변경될 때 호출됩니다.

구문

매개 변수

pszSrcFileName
형식: LPCWSTR
원본 파일의 파일 이름에 대한 포인터입니다. 이 매개 변수는 더 이상 사용되지 않으며 값은 이제 pszDstFileName의 복사본입니다. pszDstFileName
형식: LPCWSTR
대상 파일의 파일 이름에 대한 포인터입니다. ullFileSize
형식: ULONGLONG
원본 파일의 총 크기(바이트)입니다. ullBytesCopied
형식: ULONGLONG
지금까지 복사된 파일의 바이트 수입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 파일 복사 작업 중에 전송된 각 패킷에 대해 IXtfFileIOClient::CopyFiles 메서드에 의해 호출됩니다. 파일에 대한 IXtfCopyFileCallback::OnFileCopyProgress의 초기 호출은 ullBytesCopied에 0바이트를, ullFileSize에 MAX_FILE_SIZE 바이트를 지정합니다. 이 초기 호출은 새 파일 복사를 시작했음을 나타냅니다. 그런 다음 후속 IXtfCopyFileCallback::OnFileCopyProgress 호출에 지정된 파일 정보를 사용하여 파일 복사 작업 중에 진행률을 추적하고 표시할 수 있습니다. 이 콜백 함수가 HRESULT 오류 코드를 반환하면 파일 복사 작업이 중단됩니다.

요구 사항

헤더: xtffileio.h 라이브러리: xtffileio.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)

함께 보기

IXtfCopyFileCallback 인터페이스
XtfFileIO
마지막 수정일 2026년 8월 24일