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
Wbemdisp. h
Bibliothèque de types
Wbemdisp. tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemPropertySet
IID
IID _ ISWbemPropertySet

Voir aussi

SWbemPropertySet

SWbemPropertySet. Remove

SWbemProperty. Value