sx, sxd, sxe, sxi, sxn, sxr, sx- (Establecer excepciones)

  • Artículo

Los comandos sx controlan la acción que toma el depurador cuando se produce una excepción en la aplicación que se está depurando o cuando se producen determinados eventos.

sx

sx{e|d|i|n} [-c "Cmd1"] [-c2 "Cmd2"] [-h] {Exception|Event|*}

sx- [-c "Cmd1"] [-c2 "Cmd2"] {Exception|Event|*}

sxr

Parámetros

-c "Cmd1"
Especifica un comando que se ejecuta si se produce la excepción o evento. Este comando se ejecuta cuando se produce la primera oportunidad de controlar esta excepción, independientemente de si esta excepción se divide en el depurador. Debe incluir la cadena Cmd1 entre comillas. Esta cadena puede incluir varios comandos si los separa con punto y coma. El espacio entre -c y la cadena de comandos entre comillas es opcional.

-c2"Cmd2"
Especifica un comando que se ejecuta si se produce la excepción o evento y no se controla en la primera oportunidad. Este comando se ejecuta cuando se produce la segunda oportunidad de controlar esta excepción, independientemente de si esta excepción se divide en el depurador. Debe incluir la cadena Cmd2 entre comillas. Esta cadena puede incluir varios comandos si los separa con punto y coma. El espacio entre -c2 y la cadena de comandos entre comillas es opcional.

-h
Cambia el estado de control del evento especificado en lugar de su estado de interrupción. Si Event es cc, hc, bpec o ssec, no tiene que usar la opción -h .

Exception
Especifica el número de excepción en el que actúa el comando en el radix actual.

Evento
Especifica el evento en el que actúa el comando. Estos eventos se identifican mediante abreviaturas cortas. Para obtener una lista de los eventos, consulte Control de excepciones y eventos.

*
Afecta a todas las excepciones que no se denominan explícitamente para sx. Para obtener una lista de excepciones con nombre explícito, consulte Control de excepciones y eventos.

Entorno

   
Modos Modo de usuario, modo kernel
Destinos Solo depuración en vivo
Plataformas Todo

Información adicional

Para obtener más información sobre el estado de interrupción y el estado de control, descripciones de todos los códigos de evento, una lista del estado predeterminado para todos los eventos y otros métodos de control de este estado, consulte Control de excepciones y eventos.

Comentarios

El comando sx muestra la lista de excepciones para el proceso actual y la lista de todos los eventos que no son de excepción y muestra el comportamiento predeterminado del depurador para cada excepción y evento.

Los comandos sxe, sxd, sxn y sxi controlan la configuración del depurador para cada excepción y evento.

El comando sxr restablece todos los estados de filtro de excepciones y eventos a la configuración predeterminada. Por ejemplo, los comandos se borran y interrumpen y las opciones de continuación se restablecen a su configuración predeterminada.

El comando sx- no cambia el estado de control ni el estado de interrupción de la excepción o evento especificados. Este comando se puede usar si desea cambiar el comando de primera oportunidad o el comando de segunda oportunidad asociado a un evento específico, pero no desea cambiar nada más.

Si incluye la opción -h (o si se especifican los eventos cc, hc, bpec o ssec ), los comandos sxe, sxd, sxn y sxi controlan el estado de control de la excepción o evento. En todos los demás casos, estos comandos controlan el estado de interrupción de la excepción o evento.

Al establecer el estado de interrupción, estos comandos tienen los siguientes efectos:

Get-Help Nombre de estado Descripción
Sxe Romper
(Habilitado)		 Cuando se produce esta excepción, el destino se divide inmediatamente en el depurador antes de que se activen otros controladores de errores. Este tipo de control se denomina control de primera oportunidad .
sxd Segunda oportunidad de interrupción
(Deshabilitado)		 El depurador no se interrumpe para una excepción de primer riesgo de este tipo (aunque se muestra un mensaje). Si otros controladores de errores no abordan esta excepción, la ejecución se detiene y el destino se divide en el depurador. Este tipo de control se denomina control de segunda oportunidad .
sxn Salida
(Notificar)		 Cuando se produce esta excepción, la aplicación de destino no se divide en el depurador en absoluto. Sin embargo, se muestra un mensaje que notifica al usuario de esta excepción.
sxi Omitir Cuando se produce esta excepción, la aplicación de destino no se divide en el depurador en absoluto y no se muestra ningún mensaje.

Al establecer el estado de control, estos comandos tienen los siguientes efectos:

Get-Help Nombre de estado Descripción
Sxe Manejado El evento se considera controlado cuando se reanuda la ejecución.
sxd,sxn,sxi No controlado El evento se considera no controlado cuando se reanuda la ejecución.

Puede usar la opción -h junto con excepciones, no eventos. Use esta opción con ch, bpe o sse para establecer el estado de control de hc, bpec o ssec, respectivamente. Si usa la opción -h con cualquier otro evento, no tiene ningún efecto.

Use las opciones -c o -c2 con hc, bpec o ssec para asociar los comandos especificados a ch, bpe o sse, respectivamente.

En el ejemplo siguiente, el comando sxe se usa para establecer el estado de interrupción de los eventos de infracción de acceso para que se interrumpan en la primera oportunidad y para establecer el comando de primera oportunidad que se ejecutará en ese punto en r eax. A continuación, el comando sx- se usa para modificar el comando de primera oportunidad a r ebx, sin cambiar el estado de control. Por último, se muestra una parte de la salida sx , que indica la configuración actual para los eventos de infracción de acceso:

0:000> sxe -c "r eax" av

0:000> sx- -c "r ebx" av

0:000> sx
 av - Access violation - break - not handled
       Command: "r ebx"
  . . .

Consulte también