__InstanceModificationEvent class

La classe système __InstanceModificationEvent signale un événement de modification d’instance, qui est un type d’événement intrinsèque généré lorsqu’une instance change dans l’espace de noms.

La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

class __InstanceModificationEvent : __InstanceOperationEvent
{
  object PreviousInstance;
  uint8  SECURITY_DESCRIPTOR[];
  object TargetInstance;
  uint64 TIME_CREATED;
};

Membres

La classe __InstanceModificationEvent est dotée des types de membres suivants :

• Propriétés

Propriétés

La classe __InstanceModificationEvent possède ces propriétés.

PreviousInstance

Type de données : objet

Type d'accès : Lecture seule

Copie de l’instance avant la modification.

SECURITY_DESCRIPTOR

Type de données : tableau uint8

Type d'accès : Lecture seule

Descripteur utilisé par le fournisseur d’événements pour déterminer quels utilisateurs peuvent recevoir l’événement. Cette propriété est héritée de __Event.

TargetInstance

Type de données : object

Type d'accès : Lecture seule

Nouvelle version de l’instance modifiée. Cette propriété est héritée de __InstanceOperationEvent.

TIME_CREATED

Type de données : uint64

Type d'accès : Lecture seule

Valeur unique qui indique l’heure à laquelle l’événement a été généré. Il s’agit d’une valeur 64 bits représentant le nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601. Les informations sont au format UTC (Temps universel coordonné). Cette propriété est héritée de __Event.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

Notes

La classe __InstanceModificationEvent est dérivée de __InstanceOperationEvent.

Modification d’une ressource : __InstanceModificationEvent

Supposons qu’une application de gestion que vous utilisez modifie par erreur le type de démarrage d’un service sur l’un de vos serveurs. Vous souhaitez écrire un script WMI pour surveiller toutes les modifications apportées à la configuration du service. Dès qu’une modification est apportée à un service, son TargetInstance correspondant reflète la modification.

Si vous inscrivez votre intérêt pour cet événement, une modification de la configuration du service entraîne la création d’une instance de la classe __InstanceModificationEvent.

Les requêtes de notification qui demandent la notification de la modification d’une ressource et utilisent des événements intrinsèques utilisent toutes une syntaxe similaire à la suivante :

SELECT * FROM __InstanceModificationEvent WITHIN PollingInterval WHERE TargetInstance ISA 'Win32_Service' and TargetInstance.Name = 'alerter'

Exemples

L’exemple VBScript de l’événement de modification de processus Monitor sur TechNet Gallery utilise __InstanceModificationEvent pour surveiller la première occurrence d'un événement de modification d'une instance WMI pour Win32_Process.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Tous les espaces de noms WMI

Voir aussi

__InstanceOperationEvent

Classes système WMI