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

# OnFoundFile

> IXtfFindFileCallback::OnFoundFile メソッド

# IXtfFindFileCallback::OnFoundFile メソッド

検索または削除操作中にファイルが見つかったときに呼び出されます。

## 構文

```cpp theme={null}
public:
HRESULT OnFoundFile(
         LPCWSTR pszRootDirectory,
         LPCWSTR pszSearchPattern,
         LPCXTFFILEINFO pFileInfo
)  
```

### パラメーター

*pszRootDirectory*\
型: LPCWSTR

操作のルート ディレクトリ パスへのポインター。

*pszSearchPattern*\
型: LPCWSTR

操作対象のファイル名を定義する検索パターンへのポインター。\
このパラメーターは、指定したパターンに文字列を一致させるためのワイルドカード文字を受け付けます。

*pFileInfo*\
型: LPCXTFFILEINFO

見つかったファイルに関する情報を含む [XTFFILEINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) 構造体へのポインター。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

## 解説

この関数は、検索関数 [IXtfFileIOClient::FindFiles](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) や削除関数 [IXtfFileIOClient::DeleteFiles](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) の呼び出しの結果としてファイルが見つかるたびに呼び出されます。この関数は、検索または削除処理中に見つかった各ファイルに関する情報を返します。見つかった情報は、実行中のファイル I/O の進行状況をレポートするために使用できます。このコールバック関数からエラー結果を返すと、XTF I/O 操作はエラーで中止されます。

## 要件

**ヘッダー:** xtffileio.h

**ライブラリ:** xtffileio.lib

**対応プラットフォーム:** Windows (XBOX コンソール ツール用)

## 関連項目

[IXtfFindFileCallback](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)\
[IXtfFileIOClient::DeleteFiles](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[IXtfFileIOClient::FindFiles](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)


## Related topics

- [XTFFILEINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)
- [IXtfFindFileCallback インターフェイス (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)
- [RemoveDirectory](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/removedirectory-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Delete Files](https://docs.xbox.com/api-reference/file/delete-files.md)
- [Finalize File Uploads](https://docs.xbox.com/api-reference/file/finalize-file-uploads.md)