Méthode SWbemPropertySet.Add

Article
06/13/2023

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

Voir aussi

SWbemPropertySet
SWbemPropertySet.Remove
SWbemProperty.Value

Partager via