SWbemPropertySet オブジェクト
SWbemPropertySet オブジェクトは、SWbemProperty オブジェクトのコレクションです。 Add メソッドを使用した項目のコレクションへの追加、Item メソッドを使用したコレクションからの項目の取得、Remove メソッドを使用したコレクションからの項目の削除を実行できます。 詳細については、コレクションへのアクセスに関する記事を参照してください。 このオブジェクトは、VBScript の CreateObject 呼び出しでは作成できません。
SWbemPropertySet コレクションを構成する SWbemProperty オブジェクトは、単一の WMI クラスまたはインスタンスのプロパティを記述するために使用されます。
メンバー
SWbemPropertySet オブジェクトには、次の種類のメンバーがあります。
メソッド
SWbemPropertySet オブジェクトには、次のメソッドがあります。
| メソッド | 説明 |
|---|---|
| 追加 |
SWbemProperty オブジェクトを SWbemPropertySet コレクションに追加します。 |
| Item | コレクションから名前付き SWbemProperty を取得します。 これは、このオブジェクトの既定のメソッドです。 |
| [削除] | コレクションから SWbemProperty オブジェクトを削除します。 |
プロパティ
SWbemPropertySet オブジェクトには、次のプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
Count |
読み取り専用 |
SWbemPropertySet コレクション内の項目の数。 |
例
次の VBScript サンプルは、プロパティがオーバーライドされた場合に SWbemPropertySet.Remove が wbemErrResetToDefault を返す可能性があるしくみを示しています。
on error resume next
'Create a keyed class with a defaulted property
set service = GetObject("Winmgmts:")
set emptyclass = service.Get
emptyclass.path_.class = "REMOVETEST00"
set prop = emptyclass.properties_.add ("p", 19)
prop.qualifiers_.add "key", true
emptyclass.properties_.add ("q", 19).Value = 12
emptyclass.put_
'create an instance and override the property
set instance = service.get ("RemoveTest00").spawninstance_
instance.properties_("q").Value = 24
instance.properties_("p").Value = 1
instance.put_
'retrieve the instance and remove the property
set instance = service.get ("removetest00=1")
set property = instance.properties_ ("q")
WScript.echo "Overridden value of property is [24]:", property.value
WScript.echo ""
instance.properties_.remove "q"
set property = instance.properties_ ("q")
WScript.echo "Value of property after removal is [12]:", property.value
WScript.echo ""
if err <> 0 then
WScript.Echo "0x" & Hex(Err.Number), Err.Description, Err.Source
end if
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| Header |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_SWbemPropertySet |
| IID |
IID_ISWbemPropertySet |