Método IDebugControl3::GetNumberEvents (dbgeng.h)
O método GetNumberEvents retorna o número de eventos para o destino atual, se o número de eventos for corrigido.
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, Os eventos serão definidos como o número de eventos disponíveis. Caso contrário, os eventos serão definidos como um.
Valor de retorno
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido e Eventos contém o número total de eventos possíveis para o destino. |
|
O método foi bem-sucedido, mas Eventos 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 diferentes pontos durante a execução do destino. |
Observações
Os arquivos de despejo de falha 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 falha, esse método definirá Eventos para 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 não treinado de eventos, esse método definirá Eventos para o número de eventos disponíveis no momento e retornará S_FALSE.
Para obter mais informações, consulte o tópico de Informações do Evento.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |