Método IDebugControl3::GetNumberEvents (dbgeng.h)
O método GetNumberEvents retornará o número de eventos para o destino atual, se o número de eventos for fixo.
HRESULT GetNumberEvents(
[out] PULONG Events
);
[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.
Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.
Código de retorno | Descrição |
---|---|
|
O método foi bem-sucedido e Events contém o número total de eventos possíveis para o destino. |
|
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. |
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.
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | dbgeng.h (inclua Dbgeng.h) |