CComEnumImpl::Clone

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

IEnumXXXX::Clone メソッドの実装を提供します。これは、CComEnum 型のオブジェクトを作成し、そのオブジェクトを現在のオブジェクトで使用されているものと同じ配列および反復子で初期化し、新しく作成したオブジェクトのインターフェイスを返すことによって実現します。

STDMETHOD(Clone)(
   Base** ppEnum 
);

パラメータ

ppEnum
[出力] 現在の列挙子からクローン作成された新規オブジェクトの列挙子インターフェイス。

戻り値

標準の HRESULT 値を返します。

解説

クローン作成された列挙子は、元の列挙子が使用しているデータのコピーを作成したり、そのデータの所有権を保持したりすることはありません。その代わりに、クローン作成された列挙子は、元の列挙子が使用しているデータを必要なときに確実に使用できるように、必要に応じて COM 参照を使用して元の列挙子を有効な状態に保ちます。