次の方法で共有

IFsiDirectoryItem2::AddTreeWithNamedStreams メソッド (imapi2fs.h)

  • [アーティクル]

ディレクトリ ツリーの内容と、すべてのファイルに関連付けられている名前付きストリームをファイル システム イメージに追加します。

構文

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

パラメーター

[in] sourceDirectory

作成するディレクトリ ツリーの相対パスを含む文字列。 パスには、ファイル システムの名前付け規則に従って有効な文字のみを含める必要があります。 このパラメーターを NULL にすることはできません。

メモ ルート ディレクトリ項目からこのメソッドを呼び出すときは、完全パスを指定する必要があります。
 

[in] includeBaseDirectory

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

戻り値

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

リターン コード/値 Description
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
値: 0x00AAB15FL
 この機能は現在のファイル システム リビジョンではサポートされていないため、この機能なしで作成されます。
IMAPI_E_INVALID_PARAM
値: 0xC0AAB101
 パラメーター '%1!ls!' に指定された値 無効です。
IMAPI_E_NOT_IN_FILE_SYSTEM
値: 0xC0AAB10B
 ls!' はファイル システムの一部ではありません。 この操作を完了するには、追加する必要があります。
IMAPI_E_DATA_STREAM_CREATE_FAILURE
値: 値: 0xC0AAB12AL
 '%1!ls!' のデータ ストリームの作成中にエラーが発生しました。
IMAPI_E_DATA_STREAM_READ_FAILURE
値: 0xC0AAB129L
 ファイル '%1!ls!' に指定されたストリームからデータを読み取ることができません。
IMAPI_E_READONLY
値: 0xC0AAB102
 参照されている IFileSystemImage オブジェクトは読み取り専用モードです。
IMAPI_E_DUP_NAME
値: 0xC0AAB112L
 '%1!ls!' 名前は既に存在します。
IMAPI_E_IMAGE_SIZE_LIMIT
値: 0xC0AAB120L
 '%1!ls!' を追加すると、結果イメージのサイズが現在構成されている制限よりも大きくなります。
IMAPI_E_DATA_STREAM_INCONSISTENCY
値: 0xC0AAB128L
 ファイル '%1!ls!' に指定されたデータ ストリームに一貫性がありません。% 2!I64d! バイト、 %3!I64d!
E_OUTOFMEMORY
値: 0x8007000EL
 必要なメモリを割り当てませんでした。

解説

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

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

ファイル システム イメージは、ソース ディレクトリの適切なディレクトリとファイルで上書きされます。 処理中に例外が発生した場合、ファイル システム イメージは以前の状態に戻ります。

このメソッドが、結果のイメージでの作成が有効になっているファイル システムの一覧に UDF が含まれていないファイル システム オブジェクトに対して呼び出された場合、または UDF リビジョンが 2.00 未満の場合、このメソッドは成功コード IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTEDを返します。 これは、UDF リビジョン 2.00 以降がファイル システム オブジェクトで有効になっていない限り、名前付きストリームが追加されたが、結果のファイル システム イメージには表示されないことを示します。

代替データ ストリーム (ADS) を使用する場合は、ファイル システム イメージに 1000 ストリームの制限があることに注意することが重要です。 この数を超えると、データが失われます。

この方法は、Windows Server 2003 Service Pack 1 (SP1)、Windows XP with Service Pack 2 (SP2)、Windows Vista (Windows Feature Pack for Storage) でサポートされています。 この更新プログラム パッケージによって提供されるすべての機能は、Windows 7 および Windows Server 2008 R2 でネイティブにサポートされています。

要件

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

関連項目

IFsiDirectoryItem2