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

# FindFiles

> IXtfFileIOClient::FindFiles 메서드

# IXtfFileIOClient::FindFiles 메서드

개발 콘솔에서 파일을 검색합니다.

## 구문

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

### 매개 변수

*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

검색에서 재귀할 디렉터리 수준 수입니다.

*dwFlags*\
형식: DWORD

파일을 검색하는 방법을 지정하는 플래그의 비트별 OR 조합입니다.

*pCallback*\
형식: IXtfFindFileCallback \*

파일이 발견될 때 호출할 [IXtfFindFileCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md) 콜백에 대한 포인터입니다.

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## 요구 사항

**헤더:** xtffileio.h

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

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

## 설명

파일을 찾을 때 *dwIncludeAttributes* 및 *dwExcludeAttributes*는 어떤 파일이 반환되는지에 대한 필터 역할을 하며, 파일을 찾을 때 어떤 파일 특성이 반환되는지에 대한 필터 역할은 하지 않습니다. [IXtfFindFileCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)의 **onfindfile** 함수 호출은 반환되는 각 파일에 대해 호출됩니다. 콜백 함수는 발견된 각 파일에 대한 정보를 반환합니다. 반환된 정보를 사용하여 진행률 정보를 반환할 수 있습니다.

## 함께 보기

[IXtfFileIOClient 인터페이스](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)\
[IXtfFindFileCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)


## Related topics

- [OnFoundFile](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)
- [IXtfFindFileCallback 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)
- [DeleteFiles](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [SetFileAttributes](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/setfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)