__InstanceCreationEvent-Klasse

  • Artikel

Die Systemklasse __InstanceCreationEventmeldet ein Ereignis zur Erstellung einer Instanz. Hierbei handelt es sich um ein systeminternes Ereignis, das beim Hinzufügen einer neuen Instanz zum Namespace generiert wird.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge aufgeführt, nicht in MOF-Reihenfolge.

Syntax

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

Member

Die Klasse __InstanceCreationEvent verfügt über folgende Membertypen:

Eigenschaften

Die Klasse __InstanceCreationEvent verfügt über folgende Eigenschaften.

SECURITY_DESCRIPTOR

Datentyp: uint8-Array

Zugriffstyp: Schreibgeschützt

Deskriptor, der vom Ereignisanbieter verwendet wird, um zu bestimmen, welche Benutzer*innen das Ereignis empfangen können. Diese Eigenschaft wird von _Event geerbt.

TargetInstance

Datentyp: object

Zugriffstyp: Schreibgeschützt

Kopie des erstellten Instanz. Diese Eigenschaft wird von __InstanceOperationEvent geerbt.

TIME_CREATED

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Eindeutiger Wert, der den Zeitpunkt angibt, zu dem das Ereignis generiert wurde. Dies ist ein 64-Bit-Wert, der die Anzahl von 100-Nanosekunden-Intervallen seit dem 1. Januar 1601 darstellt. Diese Information wird im UTC-Format (koordinierte Weltzeit) angegeben. Diese Eigenschaft wird von _Event geerbt.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

Bemerkungen

Die Klasse __InstanceCreationEvent wird von __InstanceOperationEvent abgeleitet.

Erstellen einer Ressource: __InstanceCreationEvent

Angenommen, Sie möchten eine Benachrichtigung erhalten, wenn der Editor auf einem bestimmten Computer ausgeführt wird. Wenn der Editor ausgeführt wird, wird ein entsprechender Prozess erstellt. Prozesse können mithilfe von WMI verwaltet werden und werden durch die „Win32_Process“-Klasse dargestellt. Wenn der Editor ausgeführt wird, wird eine entsprechende Instanz der „Win32_Process“-Klasse über WMI verfügbar gemacht. Wenn Sie Ihr Interesse an diesem Ereignis registriert haben (durch Ausgeben der entsprechenden Ereignisbenachrichtigungsabfrage), führt die Verfügbarkeit dieser Instanz zum Erstellen einer Instanz der __InstanceCreationEvent-Klasse.

Für Benachrichtigungsabfragen, die eine Benachrichtigung über das Erstellen einer Ressource anfordern und systeminterne Ereignisse verwenden, wird eine Syntax ähnlich der folgenden verwendet:

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

Eine ausführlichere Erläuterung zur Verwendung der Klasse __InstanceCreationEvent zum Überwachen von Dateisystemen finden Sie unter WMI und Dateisystemüberwachung in CodeProject.

Beispiele

Im PowerShell-Beispiel Erstellen einer permanenten WMI-Ereignisregistrierung zum Überwachen von Dateien im TechNet-Katalog wird __InstanceCreationEvent als Teil eines komplexen Skripts verwendet, um eine permanente WMI-Ereignisregistrierung einzurichten.

Im PowerShell-Beispiel PowerShell und WMI – Permanente Ereignisse im TechNet-Katalog wird __InstanceCreationEvent als Teil eines Demonstrationsskripts zum Einrichten einer permanenten Ereignisregistrierung verwendet.

Im VBScript-Beispiel Überwachen von Prozesserstellungsereignissen in TechNet wird __InstanceCreationEvent verwendet, um das erste Ereignis zum Erstellen einer WMI-Instanz fürWin32_Process zu überwachen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 Windows Server 2008
Namespace
 Alle WMI-Namespaces

Weitere Informationen

__InstanceOperationEvent

WMI-Systemklassen