Classe __InstanceCreationEvent
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 |