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

# IXtfFindFileCallback::OnFoundFile Method

> IXtfFindFileCallback::OnFoundFile Method

# IXtfFindFileCallback::OnFoundFile Method

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

<a id="syntaxSection" />

## 语法

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

<a id="ID4EH" />

### 参数

*pszRootDirectory*\
类型：LPCWSTR

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

*pszSearchPattern*\
类型：LPCWSTR

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

*pFileInfo*\
类型：LPCXTFFILEINFO

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

<a id="ID4EQ" />

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

<a id="requirements" />

## 备注

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

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

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

## 另请参阅

[IXtfFindFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t)\
[IXtfFileIOClient::DeleteFiles](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m)\
[IXtfFileIOClient::FindFiles](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m)


## Related topics

- [IXtfFileIOClient::FindFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)