Méthode IDebugControl3 ::GetNumberEvents (dbgeng.h)

Article
02/23/2024

La méthode GetNumberEvents retourne le nombre d’événements pour la cible actuelle, si le nombre d’événements est fixe.

Syntaxe

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Paramètres

[out] Events

Reçoit le nombre d’événements stockés dans la cible. Si la cible propose plusieurs événements, les événements sont définis sur le nombre d’événements disponibles. Dans le cas contraire, les événements seront définis sur un.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi, et Events contient le nombre total d’événements possibles pour la cible.
S_FALSE	La méthode a réussi, mais Events contient uniquement le nombre total d’événements possibles à l’heure actuelle. Les cibles qui prennent en charge l’exécution des variables peuvent avoir différents ensembles d’événements disponibles à différents points pendant l’exécution de la cible.

Remarques

Les fichiers de vidage sur incident contiennent une liste statique d’événements ; chaque événement représente une instantané de la cible à un moment donné. Si la cible actuelle est un fichier de vidage sur incident, cette méthode définit Events sur le nombre d’événements stockés et retourne S_OK.

Les cibles en direct génèrent des événements de manière dynamique et n’ont pas nécessairement un ensemble d’événements connu. Si la cible actuelle est une cible dynamique avec un nombre d’événements sans contrainte, cette méthode définit Events sur le nombre d’événements actuellement disponibles et retourne S_FALSE.

Pour plus d’informations, consultez la rubrique Informations sur les événements.