IWbemClassObject::Clone メソッド (wbemcli.h)

IWbemClassObject::Clone メソッドは、現在のオブジェクトの完全な複製である新しいオブジェクトを返します。 新しいオブジェクトの COM 参照カウントは 1 です。

構文

HRESULT Clone(
  [out] IWbemClassObject **ppCopy
);

パラメーター

[out] ppCopy

このパラメーターを NULL にすることはできません。 現在のオブジェクトのコピーを受け取ります。 このオブジェクトが不要になった場合は 、このオブジェクトで IWbemClassObject::Release を呼び出す必要があります。

エラーが発生した場合、新しいオブジェクトは返されません。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

注釈

クラス定義を複製したり、インスタンスを複製したりするには、このメソッドを使用します。 これは、新しいコピーが変更されている間に、バックアップのためにオブジェクトの元のコピーが必要な場合に役立ちます。 同様に、1 つのソース インスタンスから多数の新しいインスタンスを作成するためにこのメソッドを使用します。 たとえば、 IWbemClassObject::SpawnInstance を使用して単一の開始インスタンスを作成し、 IWbemClassObject::Clone を使用してインスタンスの 100 個のコピーをすばやく生成します。 各オブジェクトは、その特定の値を受け取るように後で変更できます。

このメソッドを使用してクラス定義をインスタンスに変換したり、インスタンスをクラス定義に変換したりすることはできません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)
Library	WbemUuid.lib
[DLL]	CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll