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

# DeleteFiles

> IXtfFileIOClient::DeleteFiles Method

# IXtfFileIOClient::DeleteFiles Method

从开发主机中删除文件。

## 语法

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

### 参数

*pszSearchPattern*\
类型：LPCWSTR

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

*dwIncludeAttributes*\
类型：DWORD

要包含在删除中的文件属性的按位或组合。有关可能属性的列表，请参阅 [File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)。

*dwExcludeAttributes*\
类型：DWORD

要从删除中排除的文件属性的按位或组合。有关可能属性的列表，请参阅 [File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)。

*dwRecursionLevels*\
类型：DWORD

要为删除递归的目录级别数。

*dwFlags*\
类型：DWORD

指定如何删除文件的标志。这是下表中列出的宏的按位或组合。

| 值 | 宏 | 描述 |
| - | - | - |
| 0x80000000 | XTFDELETEFILE\_DEFER | 延迟文件删除。 |

*pCallback*\
类型：IXtfFindFileCallback \*

指向 [IXtfFindFileCallback](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md) 回调的指针，用于在找到要删除的文件时调用。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

删除文件时，*dwIncludeAttributes* 和 *dwExcludeAttributes* 用作对要删除哪些文件的过滤器，而不是用作在删除文件时对要删除哪些文件属性的过滤器。将为每个要删除的文件调用 [IXtfFindFileCallback](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md) 的 **onfindfile** 函数调用。回调函数将返回有关每个要删除文件的信息。返回的信息可用于返回有关删除进度的进度信息。

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

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

## 另请参阅

[IXtfFileIOClient Interface](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)\
[IXtfFindFileCallback](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)


## Related topics

- [Delete Files](https://docs.xbox.com/api-reference/file/delete-files.md)
- [PFDataDeleteFilesGetResultSize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfdata/functions/pfdatadeletefilesgetresultsize.md)
- [OnFoundFile](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)
- [Entity API 重构升级教程](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [PlayFab GDPR - 删除玩家数据](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)