Classe __TimerEvent

La classe système __TimerEvent signale un événement généré par WMI en réponse à la requête d’un consommateur pour un événement de minuterie d’intervalle ou un événement de minuterie absolu. Un événement du minuteur d’intervalle est un événement qui se produit à intervalles réguliers. Un événement de minuteur absolu est un événement qui se produit à un moment spécifique. Les événements du minuteur peuvent se produire dans n’importe quel 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 __TimerEvent : __Event
{
  uint32 NumFirings;
  uint8  SECURITY_DESCRIPTOR[];
  string TimerId;
  uint64 TIME_CREATED;
};

Membres

La classe __TimerEvent comprend les types de membres suivants :

• Propriétés

Propriétés

La classe __TimerEvent comprend les propriétés suivantes.

NumFirings

Type de données : uint32

Type d'accès : Lecture seule

Nombre de fois que l’événement s’est produit avant la remise d’une notification au consommateur.

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.

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.

TimerId

Type de données : chaîne

Type d'accès : Lecture seule

Instance de la sous-classe __TimerInstruction qui a provoqué le déclenchement de cet événement par WMI. Les consommateurs spécifient une identification du minuteur dans la propriété TimerId de la sous-classe __TimerInstruction qu’ils créent pour s’inscrire.

Notes

La classe __TimerEvent est dérivée de __Event.

Les consommateurs d’événements s’inscrivent pour un événement de minuteur absolu en créant une instance de la classe système __AbsoluteTimerInstruction. Ils s’inscrivent pour un événement du minuteur d’intervalle en créant une instance de la classe système __IntervalTimerInstruction.

Pendant le fonctionnement normal, la propriété NumFirings a la valeur 1. Lorsqu’il n’est pas possible d’atteindre le consommateur ou que l’intervalle de déclenchement est beaucoup plus rapide que la possibilité de remettre l’événement, NumFirings est défini sur un nombre supérieur à 1. Lorsque NumFirings est supérieur à 1, WMI fusionne automatiquement de nombreux événements de minuteur dans le même événement. Cette fusion est similaire à ce qui se produit avec les messages WM_TIMER dans la programmation Windows.

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

__Event

Classes système WMI

Réception d’un événement chronométré ou répétitif

Réception d’événements en permanence

Réception d’événements pendant la durée de votre application