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

# IXtfFileIOClient::DeleteFiles Method

> IXtfFileIOClient::DeleteFiles Method

# IXtfFileIOClient::DeleteFiles Method

从开发主机中删除文件。

<a id="syntaxSection" />

## 语法

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

<a id="ID4EH" />

### 参数

*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](/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t) 回调的指针，用于在找到要删除的文件时调用。

<a id="ID4EQ" />

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

<a id="requirements" />

## 备注

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

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

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

<a id="ID4EPC" />

## 另请参阅

<a id="ID4ERC" />

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


## Related topics

- [IXtfFileIOClient::CopyFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::FindFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::GetFileInfo Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileinfo-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::GetFileAttributes Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::GetFileSize Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfilesize-ixtffileioclient-xtffileio-xbox-microsoft-m.md)