IFsiDirectoryItem：：RemoveTree 方法 (imapi2fs.h)

从文件系统映像中删除指定的目录树。

语法

HRESULT RemoveTree(
  [in] BSTR path
);

[in] path

包含要删除的目录名称的字符串。路径相对于当前目录项。

S_OK成功后返回，但其他成功代码可能由于实现而返回。以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：

返回代码	说明
E_POINTER	路径参数不是有效的指针。
IMAPI_E_INVALID_PARAM	为参数 %1！ls！指定的值无效。值：0xC0AAB101
IMAPI_E_INVALID_PATH	路径 '%1！s！' 格式不正确或包含无效字符。值：0xC0AAB110
IMAPI_E_NOT_IN_FILE_SYSTEM	ls！' 不是文件系统的一部分。必须添加它才能完成此操作。值：0xC0AAB10B
IMAPI_E_READONLY	FileSystemImage 对象处于只读模式。值：0xC0AAB102
IMAPI_E_DIR_NOT_FOUND	指定的目录不存在。
IMAPI_E_DIR_NOT_EMPTY	目录 %1！s！不为空。值：0xC0AAB10A
IMAPI_E_FSI_INTERNAL_ERROR	发生内部错误： %1！ls！。值：0xC0AAB100
IMAPI_E_NOT_DIR	指定的路径 %1！ls！不标识目录。值：0xC0AAB109

目录项必须存在于文件系统映像中。

可以通过调用根目录项的此方法并将路径设置为单个路径分隔符 (\) 来删除整个文件系统映像。


最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi2fs.h