> ## 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.

# IXtfDeployCallback::OnDeployFileProgress

> IXtfDeployCallback::OnDeployFileProgress

# IXtfDeployCallback::OnDeployFileProgress

콘솔로 파일을 배포하는 진행 상황을 보고하기 위해 호출되는 콜백입니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
public:
HRESULT OnDeployFileProgress(
         LPCWSTR pszFilePath,
         ULONGLONG ullBytesTransferred,
         ULONGLONG ullFileSize
)  
```

<a id="parametersSection" />

### 매개 변수

*pszFilePath*\
형식: LPCWSTR

배포 중인 파일의 경로입니다.

*ullBytesTransferred*\
형식: ULONGLONG

지금까지 전송된 바이트 수입니다.

*ullFileSize*\
형식: ULONGLONG

전송 중인 파일의 총 크기(바이트)입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

배포를 계속하려면 `S_OK`를 반환하거나, 배포를 취소하려면 HRESULT 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

이 콜백은 배포 시스템이 배포 중인 PC에서 콘솔로 파일을 전송할 때 호출됩니다. 이 콜백은 파일별로 버퍼 블록이 성공적으로 전송될 때마다 한 번씩 호출됩니다. 이 콜백은 성공적으로 전송된 각 파일에 대해 항상 최소 두 번 호출됩니다. 배포 시작 시 한 번, 배포 종료 시 한 번 호출됩니다. 길이가 0인 파일이 배포되는 경우 두 호출 모두 0바이트 중 0바이트가 전송되었음을 보고합니다. 배포 프로세스 중에 파일을 평가하는 방식과 콜백이 호출되는 시점에 대한 자세한 내용은 [IXtfDeployCallback 인터페이스](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)를 참조하세요.

<Note>배포용 파일 전송 프로세스는 여러 스레드를 사용합니다. 코드에서는 `pszFilePath`로 진행률 메시지를 상관시키고 일반적인 다중 스레딩 문제로부터 보호해야 합니다.</Note>

`IXtfDeployCallback`의 다른 콜백과 마찬가지로 이 콜백이 `S_OK`를 반환하면 배포 프로세스가 계속됩니다. 이 콜백이 `HRESULT` 오류 코드를 반환하면 배포 프로세스가 즉시 취소됩니다. 이미 전송되거나 삭제된 파일은 그대로 유지되며, 부분적으로 전송된 파일은 잘린 형태로 닫힙니다. 콘솔의 모든 파일이 완전하고 최신 상태인지 확인하려면 다른 배포를 완료해야 합니다.

## 요구 사항

**헤더:** xtfapplication.h

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

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

## 함께 보기

[IXtfDeployCallback 인터페이스](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployExtraFileDetected](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md)
- [IXtfDeployCallback::OnDeployExtraFileRemoved](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployChangeEvaluation](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployMetrics 메서드](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [IXtfDeployCallback::OnDeployError](/ko/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)