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

> Método IXtfFindFileCallback::OnFoundFile

# Método IXtfFindFileCallback::OnFoundFile

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

## Sintaxe

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

### 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) que contém informações sobre o arquivo localizado.

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT.

## 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) e [IXtfFileIOClient::DeleteFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md). 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)\
[IXtfFileIOClient::DeleteFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[IXtfFileIOClient::FindFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)


## Related topics

- [Interface IXtfFindFileCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)
- [XTFFILEINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)
- [RemoveDirectory](https://docs.xbox.com/pt-BR/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)