> ## 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 方法

> IXtfFindFileCallback::OnFoundFile 方法

# IXtfFindFileCallback::OnFoundFile 方法

在尋找或刪除作業期間找到檔案時呼叫。

<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](/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 結構的指標，其中包含所找到之檔案的相關資訊。

<a id="ID4EQ" />

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

<a id="requirements" />

## 備註

每次因呼叫尋找或刪除函式 [IXtfFileIOClient::FindFiles](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) 和 [IXtfFileIOClient::DeleteFiles](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m) 而找到檔案時，都會呼叫此函式。此函式會傳回在尋找或刪除程序期間找到的每個檔案的相關資訊。找到的資訊可用來回報所要求之檔案 IO 的進度。從此回呼函式傳回錯誤結果，將會中止 xtf IO 作業並產生錯誤。

## 需求

**標頭：** xtffileio.h

**程式庫：** xtffileio.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

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


## Related topics

- [IXtfFindFileCallback::OnFoundFile Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFindFileCallback::OnFoundFile (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFindFileCallback::OnFoundFile 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFindFileCallback::OnFoundFile メソッド](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)