Énumération WbemChangeFlagEnum (wbemdisp.h)

  • Article

Les constantes WbemChangeFlagEnum définissent la façon dont une opération d’écriture dans une classe ou un instance est effectuée. Une opération d’écriture est exécutée par SWbemObject.Put_ ou par SWbemServicesEx.Put_. Ces indicateurs sont utilisés par SWbemObject.Put_ et SWbemObject.PutAsync_.

La bibliothèque de types de scripts WMI, WbemDisp.tlb, définit ces constantes. Les applications Visual Basic peuvent accéder à cette bibliothèque ; Les langages de script doivent utiliser directement la valeur de la constante, sauf s’ils utilisent le format de fichier XML WSH (Windows Script Host). Pour plus d’informations, consultez Utilisation de la bibliothèque de types de scripts WMI.

Syntax

typedef enum WbemChangeFlagEnum {
  wbemChangeFlagCreateOrUpdate = 0,
  wbemChangeFlagUpdateOnly = 0x1,
  wbemChangeFlagCreateOnly = 0x2,
  wbemChangeFlagUpdateCompatible = 0,
  wbemChangeFlagUpdateSafeMode = 0x20,
  wbemChangeFlagUpdateForceMode = 0x40,
  wbemChangeFlagStrongValidation = 0x80,
  wbemChangeFlagAdvisory = 0x10000
} ;

Constantes

 
wbemChangeFlagCreateOrUpdate
Valeur : 0
Entraîne la création de la classe ou de l’instance, si elle n’existe pas, ou le remplacement s’il existe déjà.
wbemChangeFlagUpdateOnly
Valeur : 0x1
Provoque la mise à jour de l’appel. Pour que l’appel réussisse, la classe ou l’instance doit exister.
wbemChangeFlagCreateOnly
Valeur : 0x2
Utilisé pour la création uniquement. L’appel échoue si la classe ou instance existe déjà.
wbemChangeFlagUpdateCompatible
Valeur : 0
Permet à une classe d’être mise à jour s’il n’existe aucune classe dérivée et qu’il n’y a pas d’instances pour cette classe. Il autorise également les mises à jour dans tous les cas si la modification concerne uniquement des qualificateurs non importants (par exemple, le qualificateur Description ). Si la classe comprend des instances, la mise à jour échouera. Cet indicateur est utilisé pour la compatibilité avec les versions précédentes de WMI.
wbemChangeFlagUpdateSafeMode
Valeur : 0x20
Autorise les mises à jour des classes, même s’il existe des classes enfants, tant que la modification n’entraîne aucun conflit avec les classes enfants. Un exemple de mise à jour que cet indicateur autoriserait serait d’ajouter une nouvelle propriété à la classe de base qui n’est pas mentionnée précédemment dans l’une des classes enfants. Si la classe comprend des instances, la mise à jour échouera.
wbemChangeFlagUpdateForceMode
Valeur : 0x40
Force les mises à jour des classes lorsqu’il existe des classes enfants en conflit.

Un exemple de mise à jour que cet indicateur force serait si un qualificateur de classe était défini dans une classe enfant et que la classe de base tentait d’ajouter le même qualificateur en conflit avec l’existant. En mode force, ce conflit est résolu en supprimant le qualificateur dans la classe enfant. Si la classe comprend des instances, la mise à jour échouera.

L’utilisation du mode force pour mettre à jour une classe statique entraîne la suppression de toutes les instances de cette classe. Forcer la mise à jour sur les classes de fournisseur ne supprime pas les instances de la classe .
wbemChangeFlagStrongValidation
Valeur : 0x80
: Avertit le système d’exploitation de retourner un échec sur les opérations put à toutes les instances système non valides. Des exemples de telles instances sont des instances liées aux événements, telles que des filtres, des liaisons ou des fournisseurs. Par défaut, si ces instances ne sont pas valides, l’opération put signale la réussite, mais une erreur est signalée dans le journal.
wbemChangeFlagAdvisory
Valeur : 0x10000

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

Voir aussi

Constantes de l'API de script