Metodo IDebugControl3::GetNumberEvents (dbgeng.h)

Articolo
02/25/2024

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, gli eventi verranno impostati sul numero di eventi disponibili. In caso contrario, gli eventi verranno impostati su uno.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

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

Commenti

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, questo metodo imposta Eventi sul numero di eventi archiviati e restituisce S_OK.

Le destinazioni live generano eventi dinamicamente e non hanno necessariamente un set noto di eventi. Se la destinazione corrente è una destinazione live 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.