Compartilhar via

Método IDebugBreakpoint2::GetPassCount (dbgeng.h)

  • Artigo

O método GetPassCount retorna o número de vezes que o destino foi originalmente necessário para alcançar o local do ponto de interrupção antes que o ponto de interrupção seja disparado.

Sintaxe

HRESULT GetPassCount(
  [out] PULONG Count
);

Parâmetros

[out] Count

O número de vezes que o destino foi originalmente necessário para atingir o ponto de interrupção antes de ser disparado. O número de vezes que o destino foi originalmente necessário para passar o ponto de interrupção sem acioná-lo é o valor retornado para Count, menos um.

Retornar valor

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
 

Esse método também pode retornar valores de erro. Para obter mais informações, consulte Valores retornados.

Comentários

O método GetPassCount retorna o número de ocorrências que originalmente eram necessárias para disparar o ponto de interrupção. O método GetCurrentPassCount retorna o número de ocorrências que ainda devem ocorrer para disparar o ponto de interrupção. Por exemplo, se um ponto de interrupção foi criado com uma contagem de aprovação de 20 e houve 5 passes até agora, esse método GetPassCount retorna 20 e GetCurrentPassCount retorna 15.

Depois que o destino atingir o ponto de interrupção o suficiente para acioná-lo, o ponto de interrupção será disparado sempre que for atingido, a menos que você chame SetPassCount. Você também pode chamar SetPassCount para alterar a contagem de passagens antes que o ponto de interrupção seja disparado. Essa chamada redefine a contagem de aprovação original e a contagem de aprovação restante.

Se o depurador executar o código no local do ponto de interrupção ao percorrer o código, essa execução não contribuirá para o número de vezes que permanecem antes que o ponto de interrupção seja disparado.

O método GetParameters também retorna as informações retornadas em Count.

Para obter mais informações sobre propriedades de ponto de interrupção, consulte Controlando sinalizadores e parâmetros de ponto de interrupção.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)