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

# Método IXtfFindFileCallback::OnFoundFile

> Método IXtfFindFileCallback::OnFoundFile

# Método IXtfFindFileCallback::OnFoundFile

Chamado quando um arquivo é encontrado durante uma operação de localização ou exclusão.

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4EH" />

### Parâmetros

*pszRootDirectory*\
Tipo: LPCWSTR

Ponteiro para o caminho do diretório raiz da operação.

*pszSearchPattern*\
Tipo: LPCWSTR

Ponteiro para o padrão de pesquisa que define os nomes dos arquivos da operação.\
Esse parâmetro aceita caracteres curinga para corresponder cadeias de caracteres ao padrão indicado.

*pFileInfo*\
Tipo: LPCXTFFILEINFO

Ponteiro para uma estrutura [XTFFILEINFO](/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) que contém informações sobre o arquivo localizado.

<a id="ID4EQ" />

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT.

<a id="requirements" />

## Comentários

Essa função é chamada sempre que um arquivo é encontrado como resultado de uma chamada às funções de localização ou exclusão [IXtfFileIOClient::FindFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) e [IXtfFileIOClient::DeleteFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m). Essa função retornará informações sobre cada arquivo encontrado durante o processo de localização ou exclusão. As informações encontradas podem ser usadas para relatar o progresso da E/S de arquivo solicitada. Retornar um resultado de erro dessa função de retorno de chamada anulará a operação de E/S do XTF com um erro.

## Requisitos

**Cabeçalho:** xtffileio.h

**Biblioteca:** xtffileio.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

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


## Related topics

- [Método IXtfFileIOClient::FindFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfCopyFileCallback::OnEndFileCopy](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [Método IXtfCopyFileCallback::OnFileCopyProgress](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [Método IXtfCopyFileCallback::OnStartFileCopy](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [Método IXtfFileIOClient::RemoveDirectory](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/removedirectory-ixtffileioclient-xtffileio-xbox-microsoft-m.md)