> ## 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::OnStartFileCopy 메서드

> IXtfCopyFileCallback::OnStartFileCopy 메서드

# IXtfCopyFileCallback::OnStartFileCopy 메서드

개발 콘솔의 두 위치 간에 파일 복사가 시작될 때 호출됩니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
public:
HRESULT OnStartFileCopy(
         LPCWSTR pszRootDirectory,
         LPCWSTR pszSearchPattern,
         LPCXTFFILEINFO pSrcFileInfo,
         LPCWSTR pszDstFileName
)  
```

<a id="parametersSection" />

### 매개 변수

*pszRootDirectory*\
형식: LPCWSTR

복사의 루트 디렉터리 경로에 대한 포인터입니다.

*pszSearchPattern*\
형식: LPCWSTR

복사할 원본 파일의 파일 이름을 정의하는 검색 패턴에 대한 포인터입니다. 이 매개 변수는 지정된 패턴과 일치하는 문자열을 위해 와일드카드 문자를 허용합니다.

*pSrcFileInfo*\
형식: LPCXTFFILEINFO

복사된 파일에 대한 정보를 포함하는 [XTFFILEINFO](/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 구조체에 대한 포인터입니다.

*pszDstFileName*\
형식: LPCWSTR

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

<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) 메서드에 의해 한 번 호출됩니다. [XTFFILEINFO](/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 구조체에서 반환되는 파일 크기는 복사해야 하는 파일 크기의 합계(바이트)를 나타냅니다. 이 합계를 사용하여 파일 복사 작업의 전체 진행률을 추적할 수 있습니다. 이 콜백 함수가 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)


## Related topics

- [IXtfCopyFileCallback::OnEndFileCopy 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfBatchFileIOClient::CopyFiles 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFindFileCallback::OnFoundFile 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)