IFsiFileItem2::AddStream メソッド (imapi2fs.h)
名前付きストリームをファイル システム イメージ内の特定のファイルに関連付けます。
構文
HRESULT AddStream(
[in] BSTR name,
[in] IStream *streamData
);
パラメーター
[in] name
文字列は、名前付きストリームの名前を表します。 これにはパスを含めず、ファイル システムの名前付け規則に従って有効な文字のみを含める必要があります。
[in] streamData
結果のファイル システム イメージへの書き込みに使用される名前付きストリームの IStream インターフェイス。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード/値 | Description |
|---|---|
|
この機能は現在のファイル システム リビジョンではサポートされていないため、この機能なしで作成されます。 |
|
ポインターが無効です。 |
|
パラメーター '%1!ls!' に指定された値 無効です。 |
|
ls!' はファイル システムの一部ではありません。 この操作を完了するには、追加する必要があります。 |
|
参照先 の IFileSystemImage オブジェクトは読み取り専用モードです。 |
|
内部ファイル システム エラーが発生しました。 |
|
'%1!ls!' name は既に存在します。 |
|
ファイル '%1!ls!' に指定されたストリームからデータを読み取ることができません。 |
|
'%1!ls!' を追加すると、結果イメージのサイズが現在構成されている制限よりも大きくなります。 |
|
ファイル '%1!ls!' に指定されたデータ ストリームに不整合があります。 %2! が必要です。I64d! バイト、 %3! が見つかりました。I64d! |
|
必要なメモリを割り当てませんでした。 |
注釈
名前付きストリームを追加するファイルは、ファイル システム イメージ内に既に存在している必要があります。 このメソッドが名前付きストリームに既に存在する 名前 で呼び出されると、エラーが返され、既存の名前付きストリームは置き換えされません。
このメソッドが、結果のイメージでの作成が有効になっているファイル システムの一覧に UDF が含まれていないファイル システム オブジェクトに対して呼び出された場合、または UDF リビジョンが 2.00 未満の場合、このメソッドは成功コード IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTEDを返します。 この成功コードは、ファイル システム オブジェクトで UDF リビジョン 2.00 以降が有効になっていない限り、名前付きストリームが追加されたが、結果のファイル システム イメージには表示されないことを示します。
現在、 IMAPI_E_READONLY は、イメージの読み取り専用の状態に関係なく、インポートされたファイル システム イメージでこのメソッドが呼び出されたときに返されます。
この方法は、Windows Server 2003 Service Pack 1 (SP1)、Windows XP と Service Pack 2 (SP2)、Windows Vista で Windows Feature Pack for Storage でサポートされています。 この更新プログラム パッケージによって提供されるすべての機能は、Windows 7 および Windows Server 2008 R2 でネイティブにサポートされています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi2fs.h |