次の方法で共有

IFsiDirectoryItem::AddTree メソッド (imapi2fs.h)

  • [アーティクル]

ディレクトリ ツリーの内容をファイル システム イメージに追加します。

構文

HRESULT AddTree(
  [in] BSTR         sourceDirectory,
  [in] VARIANT_BOOL includeBaseDirectory
);

パラメーター

[in] sourceDirectory

作成するディレクトリ ツリーの相対パスを含む文字列。

ルート ディレクトリ項目からこのメソッドを呼び出すときに、完全なパスを指定します。

[in] includeBaseDirectory

sourceDirectory のディレクトリをファイル システム イメージのサブディレクトリとして含めるには、VARIANT_TRUE に設定します。 それ以外の場合は、VARIANT_FALSE。

戻り値

S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

リターン コード 説明
E_OUTOFMEMORY
 必要なメモリを割り当てませんでした。

値: 0x8007000E
E_POINTER
 ポインターが無効です。

値: 0x80004003
IMAPI_E_DIRECTORY_READ_FAILURE
 アクセス許可により、ディレクトリ ツリー内のファイルの列挙に失敗しました。

値: 0xC0AAB12BL
IMAPI_E_DATA_STREAM_CREATE_FAILURE
 アクセス許可により、ディレクトリ ツリー内の 1 つ以上のファイルにアクセスできません。

値: 0xC0AAB12A
IMAPI_E_DATA_STREAM_READ_FAILURE
 ファイル '%1!ls!' に指定されたストリームからデータを読み取ることができません。

値: 0xC0AAB129
IMAPI_E_INVALID_PARAM
 パラメーター %1!ls! に指定された値が無効です。

値: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM
 ls!' はファイル システムの一部ではありません。 この操作を完了するには、追加する必要があります。

値: 0xC0AAB10B
IMAPI_E_READONLY
 FileSystemImage オブジェクトは読み取り専用モードです。

値: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT
このファイルまたはディレクトリを追加すると、現在構成されている制限を超えるサイズの結果イメージが生成されます。

値: 0xC0AAB120
IMAPI_E_INVALID_PATH
 パス '%1!s!' 形式が正しくないか、無効な文字が含まれています。

値: 0xC0AAB110
IMAPI_E_DUP_NAME
 ls!' name は既に存在します。

値: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME
 '%1!ls!' の追加を試みます failed: %2!ls に対してファイル システム固有の一意の名前を作成できません。 ファイル システムを使用して実行します。

値: 0xC0AAB113
IMAPI_E_ISO9660_LEVELS
 ISO9660は 8 レベルのディレクトリに制限されています。

値: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS
 このファイル システム イメージには、%1!ls! のディレクトリが多すぎます。 ファイル システムを使用して実行します。

値: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND
 ディレクトリ '%1!s!' FileSystemImage 階層に見つかりません。

値: 0xC0AAB11A
 
メモGetFileAttributesEx 関数と FindFirstFile 関数によって返される値もここで返される場合があります。
 

注釈

新しいサブディレクトリの親ディレクトリは、ファイル システム イメージ内に既に存在している必要があります。

指定したソース ディレクトリ内のサブディレクトリ構造は、ファイル システム イメージに暗黙的にミラー化されます。

ファイルまたはディレクトリの競合が発生した場合は、指定されたソース ディレクトリの内容が優先されます。 ファイル システム イメージは、ソース ディレクトリの適切なディレクトリとファイルで上書きされます。

処理中に例外が発生した場合、ファイル システム イメージは以前の状態に戻ります。

要件

要件 値
サポートされている最小のクライアント Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー imapi2fs.h

こちらもご覧ください

IFsiDirectoryItem

IFsiDirectoryItem::Add

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove