> ## 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::RemoveDirectory Method

> IXtfFileIOClient::RemoveDirectory Method

# IXtfFileIOClient::RemoveDirectory Method

从开发主机中删除指定的目录。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
public:
HRESULT RemoveDirectory(
         LPCWSTR pszDirectory,
         DWORD dwFlags,
         IXtfFindFileCallback *pCallback
)  
```

<a id="parametersSection" />

### 参数

*pszDirectory*\
类型：LPCWSTR

指向要从开发主机中删除的目录的目录路径的指针。

*dwFlags*\
类型：DWORD

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

| 值          | 宏                         | 描述                          |
| ---------- | ------------------------- | --------------------------- |
| 0x1        | XTFREMOVEDIRECTORY\_FORCE | 强制执行目录删除，即使该目录包含文件或子目录也是如此。 |
| 0x80000000 | XTFDELETEFILE\_DEFER      | 延迟目录删除。                     |

*pCallback*\
类型：IXtfFindFileCallback\*

指向 [IXtfFindFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t) 回调的指针，用于在找到要删除的目录时调用。

<a id="retvalSection" />

### 返回值

类型：HRESULT

如果成功，则返回 `S_OK`；否则返回 HRESULT 错误代码。

<a id="remarksSection" />

## 备注

此函数删除开发主机上的目录。如果发生错误，此函数将返回 HRESULT 错误代码。有关特定于 XBOX 工具框架 (XTF) API 的 HRESULT 错误代码的详细信息，请参阅 [XTF 传输错误 (NDA 主题)](/tools/tools-console/commandlinetools/xtf-transport-errors)。

如果指定了 XTFREMOVEDIRECTORY\_FORCE 且要删除的目录包含文件或子目录，则会为要删除的目录中的每个文件和子目录调用 [IXtfFindFileCallback::OnFoundFile](/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m) 回调函数。目录中每个文件和子目录的信息将传递给回调函数，这些信息可用于跟踪和显示进度信息。

<a id="requirementsSection" />

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

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

<a id="seealsoSection" />

## 另请参阅

[IXtfFileIOClient::CreateDirectory](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/createdirectory-ixtffileioclient-xtffileio-xbox-microsoft-m)\
[IXtfFileIOClient Interface](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfFileIOClient::CreateDirectory Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/createdirectory-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::SetFileAttributes Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/setfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::DeleteFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-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)
