IStream_Clone

Clone メソッドは、元のストリームと同じバイトを参照する独自のシークポインタを持つ新しいストリームオブジェクトを作成する。

IStream_Clone this, ppstm

this : [comobj] IStream インターフェースの COM オブジェクト変数
ppstm : [comobj] 成功した場合、新しいストリームオブジェクトの IStream ポインタの位置へのポインタ。エラーが発生した場合、このパラメータは NULL になる。

(プラグイン / モジュール : com_misc.dll)

解説

Clone メソッドは、元のストリームと同じバイトを参照する独自のシークポインタを持つ新しいストリームオブジェクトを作成する。

[戻り値]
このメソッドは次のいずれかの値を返す。 | リターンコード | 説明 |
|----------------|---------------| |S_OK | ストリームが正常にクローンされた。|
|E_PENDING | 非同期ストレージのみ: ストリームのデータの一部または全部が現在利用できない。 |
|STG_E_INSUFFICIENTMEMORY | メモリ不足のためストリームがクローンされなかった。|
|STG_E_INVALIDPOINTER | ppStm ポインタが有効でない。| |STG_E_REVERTED |
トランザクションツリーの上位の revert 操作によりオブジェクトが無効化された。|

[備考]
Clone
メソッドは、同じバイトにアクセスするが別のシークポインタを使用する新しいストリームオブジェクトを作成する。新しいストリームオブジェクトはソースストリームオブジェクトと同じデータを参照する。一方のオブジェクトに書き込まれた変更は、もう一方にもただちに反映される。範囲ロックはストリームオブジェクト間で共有される。クローンされたストリームインスタンスのシークポインタの初期設定は、クローン操作時の元のストリームのシークポインタの現在の設定と同じである。

情報