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

# IXtfFileIOClient::CopyFiles 메서드

> IXtfFileIOClient::CopyFiles 메서드

# IXtfFileIOClient::CopyFiles 메서드

개발 콘솔의 두 위치 간에 파일을 복사하고 작업에 대한 정보를 반환합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
public:
HRESULT CopyFiles(
         LPCWSTR pszSearchPattern,
         DWORD dwIncludeAttributes,
         DWORD dwExcludeAttributes,
         DWORD dwRecursionLevels,
         LPCWSTR pszDstFileName,
         DWORD dwFlags,
         IXtfCopyFileCallback *pCallback
)  
```

<a id="parametersSection" />

### 매개 변수

*pszSearchPattern*\
형식: LPCWSTR

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

*dwIncludeAttributes*\
형식: DWORD

복사에 포함할 파일 특성의 비트별 OR 조합입니다. 가능한 특성 목록은 [파일 특성 상수](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)를 참조하세요.

*dwExcludeAttributes*\
형식: DWORD

복사에서 제외할 파일 특성의 비트별 OR 조합입니다. 가능한 특성 목록은 [파일 특성 상수](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)를 참조하세요.

*dwRecursionLevels*\
형식: DWORD

복사에서 재귀할 디렉터리 수준 수 또는 디렉터리 트리의 모든 수준을 포함할 -1입니다.

*pszDstFileName*\
형식: LPCWSTR

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

*dwFlags*\
형식: DWORD

파일을 복사하는 방법을 지정하는 플래그입니다. 다음 표에 나열된 매크로의 비트별 OR 조합입니다.

| 값          | 매크로                | 설명            |
| ---------- | ------------------ | ------------- |
| 0x80000000 | XTFCOPYFILE\_DEFER | 파일 복사를 지연합니다. |

*pCallback*\
형식: IXtfCopyFileCallback\*

복사 상태가 변경될 때 호출할 [IXtfCopyFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t) 콜백에 대한 포인터입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

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

<a id="remarksSection" />

## 설명

**IXtfFileIOClient::CopyFiles**는 XBOX 콘솔의 한 위치에서 다른 위치로 파일을 복사하는 프로세스를 시작합니다. 파일 복사 명령의 진행 상황을 추적하려면 [IXtfCopyFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t) 인스턴스로 콜백 함수를 정의합니다. `IXtfCopyFileCallback`에는 파일 복사 작업이 시작될 때, 진행 중일 때, 마지막으로 완료된 후에 호출되는 콜백 함수가 포함되어 있습니다.\
와일드카드 문자를 사용하여 여러 파일을 복사할 때 *pszDstFileName* 매개 변수는 디렉터리로 간주되며 복사된 모든 파일이 해당 디렉터리에 배치됩니다. 디렉터리가 없으면 파일이 복사되기 전에 만들어집니다.

*dwIncludeAttributes* 및 *dwExcludeAttributes* 매개 변수는 어떤 파일이 복사되는지 나타내는 필터 역할을 합니다. 이러한 매개 변수는 파일을 복사할 때 어떤 파일 특성이 복사되는지 나타내는 필터로는 작동하지 않습니다.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtffileio.h

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

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

<a id="seealsoSection" />

## 함께 보기

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


## Related topics

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