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、SP2 を使用した Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	imapi2fs.h