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

Artigo
02/23/2024

O método GetNumberEvents retornará o número de eventos para o destino atual, se o número de eventos for fixo.

Sintaxe

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Parâmetros

[out] Events

Recebe o número de eventos armazenados no destino. Se o destino oferecer vários eventos, Eventos serão definidos como o número de eventos disponíveis. Caso contrário, Eventos serão definidos como um.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido e Events contém o número total de eventos possíveis para o destino.
S_FALSE	O método foi bem-sucedido, mas Events contém apenas o número total de eventos possíveis no momento atual. Os destinos que dão suporte à execução de variável podem ter diferentes conjuntos de eventos disponíveis em pontos diferentes durante a execução do destino.

Comentários

Os arquivos de despejo de memória contêm uma lista estática de eventos; cada evento representa um instantâneo do destino em um determinado ponto no tempo. Se o destino atual for um arquivo de despejo de memória, esse método definirá Eventos como o número de eventos armazenados e retornará S_OK.

Os destinos ao vivo geram eventos dinamicamente e não necessariamente têm um conjunto conhecido de eventos. Se o destino atual for um destino ao vivo com um número irrestrito de eventos, esse método definirá Eventos como o número de eventos disponíveis no momento e retornará S_FALSE.

Para obter mais informações, consulte o tópico Informações do evento.