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

El método GetPassCount devuelve el número de veces que el destino era originalmente necesario 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 originalmente se requería el destino 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	El método se realizó correctamente.

 

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

Observaciones

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 pasos de 20 y hasta ahora se han superado 5, 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 recuento 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 Control de marcas de punto de interrupción y parámetros.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)