IDebugControl3::GetNumberEvents-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetNumberEvents-Methode gibt die Anzahl von Ereignissen für das aktuelle Ziel zurück, wenn die Anzahl der Ereignisse festgelegt ist.

Syntax

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Parameter

[out] Events

Empfängt die Anzahl der im Ziel gespeicherten Ereignisse. Wenn das Ziel mehrere Ereignisse bietet, werden Ereignisse auf die Anzahl der verfügbaren Ereignisse festgelegt. Andernfalls werden Ereignisse auf eins festgelegt.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich, und Ereignisse enthalten die Gesamtzahl der ereignisse, die für das Ziel möglich sind.
S_FALSE	Die Methode war erfolgreich, aber Ereignisse enthält nur die Gesamtzahl der Ereignisse, die zum aktuellen Zeitpunkt möglich sind. Bei Zielen, die die Ausführung von Variablen unterstützen, stehen möglicherweise unterschiedliche Ereignissätze an verschiedenen Stellen während der Ausführung des Ziels zur Verfügung.

Hinweise

Absturzabbilddateien enthalten eine statische Liste von Ereignissen. jedes Ereignis stellt eine Momentaufnahme des Ziels zu einem bestimmten Zeitpunkt dar. Wenn das aktuelle Ziel eine Absturzabbilddatei ist, legt diese Methode Ereignisse auf die Anzahl der gespeicherten Ereignisse fest und gibt S_OK zurück.

Liveziele generieren Ereignisse dynamisch und verfügen nicht unbedingt über einen bekannten Satz von Ereignissen. Wenn das aktuelle Ziel ein Liveziel mit einer nicht eingeschränkten Anzahl von Ereignissen ist, legt diese Methode Ereignisse auf die Anzahl der derzeit verfügbaren Ereignisse fest und gibt S_FALSE zurück.

Weitere Informationen finden Sie im Thema Ereignisinformationen.