SWbemObject.SpawnInstance_ メソッド
SWbemObject オブジェクトの SpawnInstance_ メソッドを使用して、クラスの新しいインスタンスを作成します。 現在のオブジェクトは、SWbemServices.Get や SWbemServices.ExecQuery などのメソッドを介して WMI から取得したクラス定義である必要があります。 次に、このクラス定義を使用して、新しいインスタンスを作成します。 プロセス内で新しい各インスタンスをローカルに作成し、SWbemObject.Put_ を呼び出して、実際に WMI 内にインスタンスを作成します。
注意
インスタンスからインスタンスを生成することはサポートされていますが、返されたインスタンスは空です。
この構文の詳細については、「スクリプト API のドキュメント規則」を参照してください。
構文
objNewInstance = .SpawnInstance_( _
[ ByVal iFlags ] _
)
パラメーター
-
iFlags [in、省略可能]
-
予約済みで、指定する場合は 0 にする必要があります。
戻り値
成功した場合、この呼び出しは、クラスの新しいインスタンスを含む SWbemObject オブジェクトを返します。
エラー コード
SpawnInstance_ メソッドの完了後に、Err オブジェクトに次のリストのいずれかのエラー コードが含まれる場合があります。
-
wbemErrIncompleteClass - 2147749920 (0x80041020)
-
現在のオブジェクトは有効なクラス定義ではなく、新しいインスタンスを生成できません。 それが不完全であるか、または SWbemObject.Put_ を使用して WMI で登録されていません。
-
wbemErrIllegalOperation - 2147749918 (0x8004101E)
-
このメソッドがクラスの代わりにインスタンスで使用されている場合に返されます。
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
無効なパラメーターが指定されました。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
操作を完了させるための十分なメモリがありません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| Header |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |