Classe __InstanceCreationEvent

  • Article

La classe système __InstanceCreationEvent signale un événement de création instance, qui est un type d’événement intrinsèque généré lorsqu’une nouvelle instance est ajoutée à 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 __InstanceCreationEvent : __InstanceOperationEvent
{
  uint8  SECURITY_DESCRIPTOR[];
  object TargetInstance;
  uint64 TIME_CREATED;
};

Membres

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

Propriétés

La classe __InstanceCreationEvent est dotée des propriétés suivantes.

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

Copie de l’instance créé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 __InstanceCreationEvent est dérivée de __InstanceOperationEvent.

Création d’une ressource : __InstanceCreationEvent

Supposons que vous soyez intéressé par la réception d’une notification si le Bloc-notes est exécuté sur un certain ordinateur. Quand le Bloc-notes s’exécute, un processus correspondant est créé. Les processus peuvent être gérés à l’aide de WMI et sont représentés par la classe Win32_Process. Lorsque le Bloc-notes commence à s’exécuter, une instance correspondante de la classe Win32_Process devient disponible via WMI. Si vous avez inscrit votre intérêt pour cet événement (en émettant la requête de notification d’événement appropriée), la disponibilité de cette instance entraîne la création d’une instance de la classe __InstanceCreationEvent.

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

SELECT * FROM __InstanceCreationEvent WITHIN PollingInterval WHERE TargetInstance ISA 'Win32_Process' and TargetInstance.Name = 'notepad.exe'

Pour plus d’informations sur l’utilisation de __InstanceCreationEvent comme moyen de surveiller les systèmes de fichiers, consultez WMI et surveillance du système de fichiers sur CodeProject.

Exemples

L’exemple PowerShell Créer une inscription d’événement WMI permanente pour surveiller des fichiers sur la galerie TechNet utilise __InstanceCreationEvent dans le cadre d’un script complexe pour configurer une inscription d’événement WMI permanente.

L’exemple PowerShell Événements permanents WMI PowerShell sur la galerie TechNet utilise __InstanceCreationEvent dans le cadre d’un script de démonstration pour la configuration d’une inscription d’événement permanente.

L’exemple VBScript Superviser l’événement de processus de création sur TechNet utilise __InstanceCreationEvent pour superviser le premier événement de création d’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