> ## 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 の組み合わせ。指定可能な属性の一覧については、[File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) を参照してください。

*dwExcludeAttributes*\
型: DWORD

操作から除外するファイル属性のビット単位 OR の組み合わせ。指定可能な属性の一覧については、[File Attribute Constants](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/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md) コールバックへのポインター。

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は HRESULT のエラー コードを返します。

## 解説

この関数は、開発コンソール上の指定されたファイルのファイル属性を設定します。エラーが発生した場合、この関数は HRESULT のエラー コードを返します。XBOX Tools Framework (XTF) API 固有の HRESULT エラー コードの詳細については、[XTF transport errors (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xtf-transport-errors.md) を参照してください。

開発コンソール上の指定されたファイルのファイル属性を取得するには、[IXtfFileIOClient::GetFileAttributes](https://docs.xbox.com/ja-jp/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/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [GetFileAttributes](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient インターフェイス (インターフェイスの内容)](https://docs.xbox.com/ja-jp/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/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [DeleteFiles](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)