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

IFsiItem オブジェクトによって記述されたファイルまたはディレクトリをファイル システム イメージに追加します。

構文

HRESULT Add(
  [in] IFsiItem *item
);

パラメーター

[in] item

ファイル システム イメージに追加する IFsiFileItem または IFsiDirectoryItem の IFsiItemインターフェイス。

戻り値

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

リターン コード	説明
E_POINTER	ポインターが無効です。 値: 0x80004003
IMAPI_E_INVALID_PATH	パス '%1!s!' 形式が正しくないか、無効な文字が含まれています。 値: 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE	ファイル '%1!ls!' に指定されたストリームからデータを読み取ることができません。 値: 0xC0AAB129
IMAPI_E_DUP_NAME	ls!' name は既に存在します。 値: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	'%1!ls!' の追加を試みます failed: %2!ls に対してファイル システム固有の一意の名前を作成できません。 ファイル システムを使用して実行します。 値: 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT	'%1!ls!' の追加 は、結果イメージのサイズが現在の構成済みの制限を超える結果になります。 値: 0xC0AAB120
IMAPI_E_ISO9660_LEVELS	ISO9660は 8 レベルのディレクトリに制限されています。 値: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	このファイル システム イメージには、%1!ls! のディレクトリが多すぎます。 ファイル システムを使用して実行します。 値: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	ディレクトリ '%1!s!' FileSystemImage 階層に見つかりません。 値: 0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM	このファイルまたはディレクトリは、ファイル システムの一部ではありません。 この操作を完了するには、追加する必要があります。 値: 0xC0AAB10B
IMAPI_E_READONLY	FileSystemImage オブジェクトは読み取り専用モードです。 値: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT	このファイルまたはディレクトリを追加すると、現在構成されている制限を超えるサイズの結果イメージが生成されます。 値: 0xC0AAB120
E_OUTOFMEMORY	必要なメモリを割り当てませんでした。 値: 0x8007000E

 

メモ IUnknown::QueryInterface メソッドによって返される値も、ここで返される場合があります。

 

注釈

ディレクトリアイテムまたはファイルアイテムを作成するには、それぞれ IFileSystemImage::CreateDirectoryItem メソッドまたは IFileSystemImage::CreateFileItem メソッドを 呼び出します。

ファイル システム イメージに項目が追加されると、 IFsiFileItem::get_Data プロパティは読み取り専用になります。

要件

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

こちらもご覧ください

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove

IFsiFileItem