Méthode SWbemPropertySet.Remove

Article
06/29/2023

La méthode Remove de l’objet SWbemPropertySet supprime une propriété de la collection SWbemPropertySet.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API Scripting.

Syntaxe

SWbemPropertySet.Remove( _
  ByVal strName, _
  [ ByVal iFlags ] _
)

Paramètres

strName [in]: Obligatoire. Nom de l’élément à supprimer.
iFlags [entrée, facultatif]: Réservé. Si elle est spécifiée, cette valeur doit être 0 (zéro).

Valeur retournée

Cette méthode ne retourne pas de valeur.

Codes d’erreur

Une fois la méthode Remove terminée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001): Défaillance non spécifiée.
wbemErrInvalidOperation - 2147749910 (0x80041016): L’utilisateur a tenté de supprimer une propriété qui ne peut pas être supprimée.
wbemErrInvalidParameter - 2147749896 (0x80041008): Un paramètre non valide a été spécifié.
wbemErrNotFound - 2147749890 (0x80041002): La propriété spécifiée n’existe pas.
wbemErrOutOfMemory - 2147749894 (0x80041006): Mémoire insuffisante pour que cette méthode s’exécute.
wbemErrPropagatedProperty - 142927303552 (0x2147219380): L’utilisateur a tenté de supprimer une propriété sans propriétaire. La propriété est héritée d'une classe parente.
wbemErrResetToDefault - 2147758082 (0x80043002): L’utilisateur a supprimé une valeur par défaut de remplacement pour la classe actuelle. La valeur par défaut de cette propriété dans la classe parente a été réactivée.

Notes

Les propriétés ne peuvent pas être supprimées des instances de classe ou des classes dérivées avec des propriétés héritées. Ces tentatives de suppression déclenchent une erreur et la propriété n’est pas supprimée ; la propriété est réinitialisée à sa valeur par défaut.

Vous ne pouvez pas itérer une collection lors de la suppression d’éléments, car lorsque vous supprimez un élément de cette dernière, le pointeur de collection est déplacé vers l’élément suivant. Pour plus d’informations, consultez Accéder à une collection.

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.Add

Partager via