Énumération WbemChangeFlagEnum (wbemdisp.h)

Article
03/03/2024

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

Partager via