Compartilhar 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 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 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 passagem de 20 e houve 5 passagens 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ções 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)