Metodo IDebugControl3::GetNumberEvents (dbgeng.h)

Articolo
02/06/2025

Il metodo GetNumberEvents restituisce il numero di eventi per la destinazione corrente, se il numero di eventi è fisso.

Sintassi

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Parametri

[out] Events

Riceve il numero di eventi archiviati nella destinazione. Se la destinazione offre più eventi, eventi verrà impostato sul numero di eventi disponibili. In caso contrario, eventi verrà impostato su uno.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo e Eventi contiene il numero totale di eventi possibili per la destinazione.
S_FALSE	Il metodo ha avuto esito positivo, ma Eventi contiene solo il numero totale di eventi possibili al momento corrente. Le destinazioni che supportano l'esecuzione di variabili possono avere set diversi di eventi disponibili in punti diversi durante l'esecuzione della destinazione.

Osservazioni

I file di dump di arresto anomalo contengono un elenco statico di eventi; ogni evento rappresenta uno snapshot della destinazione in un determinato momento. Se la destinazione corrente è un file di dump di arresto anomalo del sistema, questo metodo imposta Eventi sul numero di eventi archiviati e restituisce S_OK.

Le destinazioni dinamiche generano eventi in modo dinamico e non hanno necessariamente un set noto di eventi. Se la destinazione corrente è una destinazione dinamica con numero non vincolato di eventi, questo metodo imposta Eventi sul numero di eventi attualmente disponibili e restituisce S_FALSE.

Per altre informazioni, vedere l'argomento informazioni sugli eventi.