> ## 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 IXtfFileIOClient::SetFileAttributes

> Método IXtfFileIOClient::SetFileAttributes

# Método IXtfFileIOClient::SetFileAttributes

Define atributos para arquivos no console de desenvolvimento.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
public:
HRESULT SetFileAttributes(
         LPCWSTR pszSearchPattern,
         DWORD dwIncludeAttributes,
         DWORD dwExcludeAttributes,
         DWORD dwRecursionLevels,
         DWORD dwAddAttributes,
         DWORD dwRemoveAttributes,
         IXtfFindFileCallback *pCallback
)  
```

<a id="parametersSection" />

### Parâmetros

*pszSearchPattern*\
Tipo: LPCWSTR

Ponteiro para o padrão de pesquisa que define os nomes dos arquivos cujos atributos serão definidos. Esse parâmetro aceita caracteres curinga para corresponder cadeias de caracteres ao padrão indicado.

*dwIncludeAttributes*\
Tipo: DWORD

Combinação OR bit a bit de atributos de arquivo a serem incluídos na operação. Confira [Constantes de atributos de arquivo](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) para obter uma lista de atributos possíveis.

*dwExcludeAttributes*\
Tipo: DWORD

Combinação OR bit a bit de atributos de arquivo a serem excluídos da operação. Confira [Constantes de atributos de arquivo](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) para obter uma lista de atributos possíveis.

*dwRecursionLevels*\
Tipo: DWORD

Número de níveis de diretório a serem percorridos recursivamente na operação.

*dwAddAttributes*\
Tipo: DWORD

Combinação OR bit a bit de atributos de arquivo a serem adicionados aos arquivos.

*dwRemoveAttributes*\
Tipo: DWORD

Combinação OR bit a bit de atributos de arquivo a serem removidos dos arquivos.

*pCallback*\
Tipo: IXtfFindFileCallback\*

Ponteiro para o retorno de chamada [IXtfFindFileCallback](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t) a ser chamado quando for encontrado um arquivo cujos atributos serão definidos.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

<a id="remarksSection" />

## Comentários

Essa função define os atributos de um arquivo especificado no console de desenvolvimento. Se ocorrer um erro, essa função retornará um código de erro HRESULT. Para obter mais informações sobre códigos de erro HRESULT específicos da API do XBOX Tools Framework (XTF), confira [Erros de transporte do XTF (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors).

Use o método [IXtfFileIOClient::GetFileAttributes](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/setfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m) para obter os atributos de um arquivo especificado no console de desenvolvimento.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtffileio.h

**Biblioteca:** xtffileio.lib

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

<a id="seealsoSection" />

## Confira também

[Interface IXtfFileIOClient](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/pt-BR/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [Método IXtfFileIOClient::GetFileAttributes](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfFileIOClient::GetFileInfo](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileinfo-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfFileIOClient::FindFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfFileIOClient::DeleteFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
