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
Wbemdisp.h
タイプ ライブラリ
Wbemdisp.tlb
[DLL]
Wbemdisp.dll
CLSID
 CLSID_SWbemObject
IID
 IID_ISWbemObject

関連項目

SWbemObject

SWbemObject.Put_

SWbemServices.Get