SWbemPropertySet. Add, méthode
La méthode Add de l’objet SWbemPropertySet ajoute un objet SWbemProperty à la collection SWbemPropertySet . Si une propriété du même nom existe déjà dans la collection, son contenu est remplacé par la nouvelle définition.
Notes
La valeur de la propriété ajoutée est null (non assigné) après cette opération. Pour définir ou modifier la valeur d’une propriété WMI, vous devez définir la propriété value de l’objet SWbemProperty retourné.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
objProperty = .Add( _
ByVal strName, _
ByVal iCIMType, _
[ ByVal bIsArray ], _
[ ByVal iFlags ] _
)
Paramètres
-
strName [ dans]
-
Obligatoire. Nom de la nouvelle propriété.
-
iCIMType [ dans]
-
Obligatoire. Entier qui représente le qualificateur CimType de la nouvelle propriété. Consultez WbemCimTypeEnum pour obtenir la liste avec les qualificateurs CimType et leurs valeurs.
-
bIsArray [ dans, facultatif]
-
Spécifie si la propriété est un type tableau. La valeur par défaut de ce paramètre est false.
-
IFlags [ dans, facultatif]
-
Réservé et doit être égal à zéro s’il est spécifié.
Valeur de retour
En cas de réussite, cette méthode retourne un objet SWbemProperty qui représente la nouvelle propriété. Dans le cas contraire, un objet null est retourné.
Codes d’erreur
Une fois la méthode Add terminée, l’objet Err peut contenir l’un des codes d’erreur ci-dessous.
-
wbemErrFailed -2147749889 (0x80041001)
-
Échec non spécifié.
-
wbemErrInvalidParameter -2147749896 (0x80041008)
-
Un paramètre non valide a été spécifié.
-
wbemErrOutOfMemory -2147749894 (0x80041006)
-
Mémoire insuffisante pour l’exécution de cette méthode.
-
wbemErrInvalidPropertyType -2147749930
-
Le qualificateur CimType n’est pas reconnu.
Exemples
Pour obtenir un exemple de code qui utilise cette méthode, consultez la rubrique SWbemPropertySet .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemPropertySet |
| IID |
IID _ ISWbemPropertySet |