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

# IXtfFindFileCallback::OnFoundFile Method

在查找或删除操作期间找到文件时调用。

## 语法

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

### 参数

*pszRootDirectory*\
类型：LPCWSTR

指向操作的根目录路径的指针。

*pszSearchPattern*\
类型：LPCWSTR

指向搜索模式的指针，该模式定义操作的文件的文件名。\
此参数接受通配符，以匹配符合指定模式的字符串。

*pFileInfo*\
类型：LPCXTFFILEINFO

指向 [XTFFILEINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) 结构的指针，该结构包含有关所找到文件的信息。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

每当调用查找或删除函数 [IXtfFileIOClient::FindFiles](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) 和 [IXtfFileIOClient::DeleteFiles](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) 找到文件时，都会调用此函数。此函数将返回在查找或删除过程中找到的每个文件的信息。找到的信息可用于报告正在进行的所请求文件 IO 的进度。从此回调函数返回错误结果将中止 xtf IO 操作并显示错误。

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

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


## Related topics

- [IXtfFindFileCallback 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)
- [XTFFILEINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)
- [RemoveDirectory](https://docs.xbox.com/zh-CN/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)