SWbemObject.Clone_ メソッド

SWbemObject オブジェクトの Clone_ メソッドは、現在のオブジェクトの複製である新しいオブジェクトを返します。

この構文の説明については、「スクリプト API のドキュメント規則」を参照してください。

構文

objWbemObject = .Clone_( _
)

パラメーター

このメソッドにはパラメーターはありません。

戻り値

成功した場合、このメソッドは新しい SWbemObject オブジェクトを返します。

エラー コード

Clone_ メソッドが完了すると、Err オブジェクトに以下のいずれかのエラー コードが含まれる場合があります。

wbemErrFailed - 2147749889 (0x80041001)

未定義のエラーが発生しました。

wbemErrInvalidParameter - 2147749896 (0x80041008)

パラメーターの指定が何もありませんでしたが、この使用法では受け付けられません。

wbemErrOutOfMemory - 2147749894 (0x80041006)

メモリ不足のため、オブジェクトを複製できません。

解説

Clone_ メソッドは、クラス定義またはインスタンスを複製するために使用します。 これは、新しいコピーの変更中に、バックアップのためにオブジェクトの元のコピーが必要なときに便利です。 同様に、1 つのソース インスタンスから多数の新しいインスタンスを作成するためにこのメソッドを使用します。 たとえば、SWbemObject.SpawnInstance_ を使用して単一の開始インスタンスを作成し、SWbemObject.Clone_ を使用してインスタンスの 100 個のコピーをすばやく生成します。 その後、オブジェクトを変更して、それぞれに特定の値を指定できます。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	Wbemdisp.h
タイプ ライブラリ	Wbemdisp.tlb
[DLL]	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject