Freigeben über


__TimerEvent-Klasse

Die __TimerEvent-Systemklasse meldet ein Ereignis, das von WMI als Reaktion auf eine Consumeranforderung für ein Intervalltimerereignis oder ein absolutes Timerereignis generiert wird. Ein Intervalltimerereignis ist ein Ereignis, das in regelmäßigen Abständen auftritt. Ein absolutes Timerereignis ist ein Ereignis, das zu einem bestimmten Zeitpunkt auftritt. Timerereignisse können in jedem beliebigen Namespace auftreten.

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 __TimerEvent : __Event
{
  uint32 NumFirings;
  uint8  SECURITY_DESCRIPTOR[];
  string TimerId;
  uint64 TIME_CREATED;
};

Member

Die __TimerEvent-Klasse verfügt über die folgenden Membertypen:

Eigenschaften

Die __TimerEvent-Klasse verfügt über die folgenden Eigenschaften.

NumFirings

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die Häufigkeit, mit der das Ereignis eingetreten ist, bevor eine Benachrichtigung an den Consumer übermittelt wurde.

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.

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 Informationen werden 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.

TimerId

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Instanz der -_TimerInstruction Unterklasse, die dazu geführt hat, dass WMI dieses Ereignis ausgelöst hat. Consumer geben eine Timeridentifikation in der TimerId-Eigenschaft der __TimerInstruction-Unterklasse an, die sie für die Registrierung erstellen.

Bemerkungen

Die __TimerEvent-Klasse wird von __Event abgeleitet.

Ereignisconsumer registrieren sich für ein absolutes Timerereignis, indem sie eine Instanz der __AbsoluteTimerInstruction-Systemklasse erstellen. Sie registrieren sich für ein Intervalltimerereignis, indem sie eine Instanz der __IntervalTimerInstruction-Systemklasse erstellen.

Während des normalen Betriebs wird die NumFirings-Eigenschaft auf 1 festgelegt. Wenn es nicht möglich ist, den Consumer zu erreichen oder das Schussintervall viel schneller ist als die Möglichkeit, das Ereignis zu übermitteln, wird NumFirings auf eine Zahl größer als 1 festgelegt. Wenn NumFirings größer als 1 ist, führt WMI automatisch viele Timerereignisse in demselben Ereignis zusammen. Diese Zusammenführung ähnelt dem, was bei WM_TIMER-Meldungen in der Windows-Programmierung auftritt.

Anforderungen

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

Siehe auch

__Event

WMI-Systemklassen

Empfangen von zeitgesteuerten oder wiederholten Ereignissen

Empfang von Ereignissen zu jeder Zeit

Empfangen von Ereignissen für die Dauer Ihrer Anwendung