IDebugControl3 ::GetNumberEvents, méthode (dbgeng.h)
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, événements est défini sur le nombre d’événements disponibles. Sinon, événements seront définis sur un.
Valeur de retour
Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.
| Retourner le code | Description |
|---|---|
|
La méthode a réussi et Événements contient le nombre total d’événements possibles pour la cible. |
|
La méthode a réussi, mais Événements 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 un instantané de la cible à un moment donné. Si la cible actuelle est un fichier de vidage sur incident, cette méthode définit Événements le nombre d’événements stockés et retourne S_OK.
Les cibles actives génèrent des événements dynamiquement et n’ont pas nécessairement un ensemble connu d’événements. Si la cible actuelle est une cible active avec un nombre d’événements non contraint, cette méthode définit Événements le nombre d’événements actuellement disponibles et retourne S_FALSE.
Pour plus d’informations, consultez la rubrique Informations sur les événements.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include Dbgeng.h) |