> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfCopyFileCallback::OnFileCopyProgress 메서드

> IXtfCopyFileCallback::OnFileCopyProgress 메서드

# IXtfCopyFileCallback::OnFileCopyProgress 메서드

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

<a id="syntaxSection" />

## 구문

```cpp theme={null}
public:
HRESULT OnFileCopyProgress(
         LPCWSTR pszSrcFileName,
         LPCWSTR pszDstFileName,
         ULONGLONG ullFileSize,
         ULONGLONG ullBytesCopied
)  
```

<a id="parametersSection" />

### 매개 변수

*pszSrcFileName*\
형식: LPCWSTR

원본 파일의 파일 이름에 대한 포인터입니다. 이 매개 변수는 더 이상 사용되지 않으며 값은 이제 pszDstFileName의 복사본입니다.

*pszDstFileName*\
형식: LPCWSTR

대상 파일의 파일 이름에 대한 포인터입니다.

*ullFileSize*\
형식: ULONGLONG

원본 파일의 총 크기(바이트)입니다.

*ullBytesCopied*\
형식: ULONGLONG

지금까지 복사된 파일의 바이트 수입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

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

<a id="remarksSection" />

## 설명

이 함수는 파일 복사 작업 중에 전송된 각 패킷에 대해 [IXtfFileIOClient::CopyFiles](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) 메서드에 의해 호출됩니다. 파일에 대한 **IXtfCopyFileCallback::OnFileCopyProgress**의 초기 호출은 `ullBytesCopied`에 0바이트를, `ullFileSize`에 MAX\_FILE\_SIZE 바이트를 지정합니다. 이 초기 호출은 새 파일 복사를 시작했음을 나타냅니다. 그런 다음 후속 **IXtfCopyFileCallback::OnFileCopyProgress** 호출에 지정된 파일 정보를 사용하여 파일 복사 작업 중에 진행률을 추적하고 표시할 수 있습니다. 이 콜백 함수가 HRESULT 오류 코드를 반환하면 파일 복사 작업이 중단됩니다.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtffileio.h

**라이브러리:** xtffileio.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## 함께 보기

[IXtfCopyFileCallback 인터페이스](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)