Méthode SWbemPropertySet.Add
La méthode Add de l’objet SWbemPropertySet ajoute un objet SWbemProperty à la collection SWbemPropertySet. Si une propriété portant le même nom existe déjà dans la collection, son contenu sera remplacé par la nouvelle définition.
Notes
La valeur de la propriété ajoutée est NULL (non attribuée) après cette opération. Pour définir ou modifier la valeur d’une propriété WMI, vous devez définir la propriété Valeur de l’objet SWbemProperty retourné.
Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API Scripting.
Syntaxe
objProperty = .Add( _
ByVal strName, _
ByVal iCIMType, _
[ ByVal bIsArray ], _
[ ByVal iFlags ] _
)
Paramètres
-
strName [in]
-
Obligatoire. Nom de la nouvelle propriété.
-
iCIMType [entrée]
-
Obligatoire. Un nombre entier qui représente le qualificatif CIMType de la nouvelle propriété. Consultez WbemCimTypeEnum pour obtenir la liste avec les qualificateurs CIMType et leurs valeurs.
-
bIsArray [entrée, facultatif]
-
Spécifie si la propriété est un type de tableau. La valeur par défaut de ce paramètre est FALSE.
-
iFlags [entrée, facultatif]
-
Réservé et doit être égal à zéro si spécifié.
Valeur retournée
Si elle fonctionne, cette méthode retourne un objet SWbemPrivilege représentant le nouveau privilège. Sinon, l’objet null sera 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)
-
Défaillance non spécifiée.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Un paramètre non valide a été spécifié.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Mémoire insuffisante pour que cette méthode s’exécute.
-
wbemErrInvalidPropertyType - 2147749930
-
Le qualificateur CIMType n’est pas reconnu.
Exemples
Pour obtenir un exemple de code utilisant cette méthode, consultez la rubrique SWbemPropertySet .
Spécifications
| 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 |