Partilhar via

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

  • Artigo

O método GetCurrentPassCount retorna o número restante de vezes que o destino deve alcançar o local do ponto de interrupção antes que o ponto de interrupção seja disparado.

Sintaxe

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

Parâmetros

[out] Count

O número restante de vezes que o destino deve atingir o ponto de interrupção antes de ser disparado. O número de vezes que o destino deve passar o ponto de interrupção sem acioná-lo é o valor retornado para Contagem, menos um.

Valor de retorno

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.

Observações

O método GetPassCount retorna o número de ocorrências que foram originalmente necessárias para disparar o ponto de interrupção. 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, 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 SetPassCount seja chamado novamente. Você também pode chamar SetPassCount para alterar a contagem de aprovação 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 no Count.

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

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)