IFsiDirectoryItem::RemoveTree 方法 (imapi2fs.h)

從檔案系統映射中移除指定的目錄樹狀結構。

語法

HRESULT RemoveTree(
  [in] BSTR path
);

參數

[in] path

包含要移除之目錄名稱的字串。 路徑相對於目前的目錄專案。

傳回值

成功時會傳回S_OK,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 描述
E_POINTER
path參數不是有效的指標。
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

另請參閱

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::AddTree

IFsiDirectoryItem::Remove