Objet SWbemPropertySet

Article
06/29/2023

Un objet SWbemPropertySet est une collection d’objets SWbemProperty. Vous pouvez ajouter des éléments à la collection à l’aide de la méthode Add, récupérer des éléments de la collection à l’aide de la méthode Item et supprimer des éléments de la collection à l’aide de la méthode Remove. Pour plus d’informations, consultez Accès à une collection. Cet objet ne peut pas être créé par l’appel VBScript CreateObject.

Les objets SWbemProperty qui composent une collection SWbemPropertySet sont utilisés pour décrire les propriétés d’une seule classe WMI ou d’une instance.

Membres

L’objet SWbemPropertySet présente les types de membres suivants :

Méthodes
Propriétés

Méthodes

L’objet SWbemPropertySet a ces méthodes.

Méthode	Description
Ajouter	Ajoute un objet SWbemProperty à la collection SWbemPropertySet.
Élément	Obtient un SWbemProperty nommé de la collection. Il s’agit de la méthode par défaut pour cet objet.
Supprimer	Supprime un objet SWbemProperty de la collection.

Propriétés

L’objet SWbemPropertySet possède ces propriétés.

Propriété	Type d’accès	Description
Count	Lecture seule	Le nombre d'éléments dans la collection SWbemPropertySet.

Exemples

L’exemple VBScript suivant montre comment SWbemPropertySet.Remove peut retourner wbemErrResetToDefault si la propriété est remplacée.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPropertySet
IID	IID_ISWbemPropertySet

Voir aussi

Objets de l’API de script

Share via