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

El método GetPassCount devuelve el número de veces que el destino se necesitaba originalmente para alcanzar la ubicación del punto de interrupción antes de que se desencadene el punto de interrupción.

Sintaxis

HRESULT GetPassCount(
  [out] PULONG Count
);

Parámetros

[out] Count

Número de veces que el destino se necesitaba originalmente para alcanzar el punto de interrupción antes de que se desencadene. Número de veces que el destino se necesitaba originalmente para pasar el punto de interrupción sin desencadenarlo es el valor que se devuelve a Count, menos uno.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente.

 

Este método también puede devolver valores de error. Para obtener más información, vea Valores devueltos.

Comentarios

El método GetPassCount devuelve el número de aciertos necesarios originalmente para desencadenar el punto de interrupción. El método GetCurrentPassCount devuelve el número de visitas que todavía deben producirse para desencadenar el punto de interrupción. Por ejemplo, si se creó un punto de interrupción con un recuento de pases de 20 y ha habido 5 pasadas hasta ahora, este método GetPassCount devuelve 20 y GetCurrentPassCount devuelve 15.

Una vez que el destino ha alcanzado el punto de interrupción suficientes veces para desencadenarlo, el punto de interrupción se desencadena cada vez que se alcanza, a menos que llame a SetPassCount. También puede llamar a SetPassCount para cambiar el recuento de pases antes de que se desencadene el punto de interrupción. Esta llamada restablece el recuento de pases original y el número de pases restante.

Si el depurador ejecuta el código en la ubicación del punto de interrupción mientras recorre el código, esta ejecución no contribuye al número de veces que permanecen antes de que se desencadene el punto de interrupción.

El método GetParameters también devuelve la información que se devuelve en Count.

Para obtener más información sobre las propiedades del punto de interrupción, vea Controlar marcas y parámetros de punto de interrupción.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (incluir Dbgeng.h)