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

# SetFileAttributes

> IXtfFileIOClient::SetFileAttributes 메서드

# IXtfFileIOClient::SetFileAttributes 메서드

개발 콘솔의 파일에 대한 특성을 설정합니다.

## 구문

```cpp theme={null}
public:
HRESULT SetFileAttributes(
         LPCWSTR pszSearchPattern,
         DWORD dwIncludeAttributes,
         DWORD dwExcludeAttributes,
         DWORD dwRecursionLevels,
         DWORD dwAddAttributes,
         DWORD dwRemoveAttributes,
         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

작업에서 재귀할 디렉터리 수준 수입니다.

*dwAddAttributes*\
형식: DWORD

파일에 추가할 파일 특성의 비트별 OR 조합입니다.

*dwRemoveAttributes*\
형식: DWORD

파일에서 제거할 파일 특성의 비트별 OR 조합입니다.

*pCallback*\
형식: IXtfFindFileCallback\*

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

### 반환 값

형식: HRESULT

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

## 설명

이 함수는 개발 콘솔에서 지정된 파일의 파일 특성을 설정합니다. 오류가 발생하면 이 함수는 HRESULT 오류 코드를 반환합니다. XBOX Tools Framework(XTF) API 관련 HRESULT 오류 코드에 대한 자세한 내용은 [XTF 전송 오류(NDA 항목)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xtf-transport-errors.md)를 참조하세요.

개발 콘솔에서 지정된 파일의 파일 특성을 가져오려면 [IXtfFileIOClient::GetFileAttributes](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/setfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md) 메서드를 사용합니다.

## 요구 사항

**헤더:** xtffileio.h

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

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

## 함께 보기

[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)


## Related topics

- [GetFileAttributes](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)
- [Attribute Install](https://docs.xbox.com/api-reference/advertising/attribute-install.md)
- [FindFiles](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [DeleteFiles](https://docs.xbox.com/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)