GetInstance()
GetInstance() メソッドは、ターゲット・ネーム・スペースからオブジェクトの 1 つのインスタンスを検索するのに使用できます。
パラメーター
表 221 は、GetInstance() メソッドに指定できるパラメーターを示します。
表 221. GetInstance() のパラメーター
|
パラメーター |
タイプ |
記述 |
| InstanceName |
ストリング |
検索するインスタンスの名前を定義します。 |
| LocalOnly |
ブール |
TRUE に設定すると、クラス定義内で指定変更されたすべてのプロパティー、メソッド、および修飾子を戻します。 |
| IncludeQualifiers |
ブール |
TRUE に設定すると、クラスのすべての修飾子、そのプロパティー、メソッド、またはメソッドのパラメーターを戻し、FALSE
に設定すると、修飾子を戻しません。 |
| IncludeClassOrigin |
ブール |
TRUE に設定すると、クラスの CLASSORIGIN 属性を戻します。 |
戻り値
GetInstance() メソッドは、指定されたクラスを戻すか、以下のエラー・コードのいずれかを戻します。
- CIM_ERR_ACCESS_DENIED
- CIM_ERR_INVALID_NAMESPACE
- CIM_ERR_INVALID_PARAMETER
- CIM_ERR_INVALID_CLASS
- CIM_ERR_NOT_FOUND
- CIM_ERR_FAILED