sx, sxd, sxe, sxi, sxn, sxr, sx- (Definir exceções)
Os comandos sx controlam a ação que o depurador executa quando ocorre uma exceção no aplicativo que está sendo depurado ou quando determinados eventos ocorrem.
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 um comando que será executado se ocorrer a exceção ou o evento. Esse comando é executado quando ocorre a primeira chance de lidar com essa exceção, independentemente de essa exceção ser dividida no depurador. Você deve colocar a cadeia de caracteres Cmd1 entre aspas. Essa cadeia de caracteres pode incluir vários comandos se você separá-los com ponto e vírgula. O espaço entre -c e a cadeia de caracteres de comando entre aspas é opcional.
-c2"Cmd2"
Especifica um comando que será executado se a exceção ou o evento ocorrer e não for tratado na primeira chance. Esse comando é executado quando ocorre a segunda chance de lidar com essa exceção, independentemente de essa exceção ser dividida no depurador. Você deve colocar a cadeia de caracteres Cmd2 entre aspas. Essa cadeia de caracteres pode incluir vários comandos se você separá-los com ponto e vírgula. O espaço entre -c2 e a cadeia de caracteres de comando entre aspas é opcional.
-h
Altera a manipulação do evento especificado status em vez de sua status de interrupção. Se Event for cc, hc, bpec ou ssec, você não precisará usar a opção -h .
Exceção
Especifica o número de exceção em que o comando atua no radix atual.
Evento
Especifica o evento no qual o comando atua. Esses eventos são identificados por abreviações curtas. Para obter uma lista dos eventos, consulte Controlando exceções e eventos.
*
Afeta todas as exceções que não são nomeadas explicitamente para sx. Para obter uma lista de exceções explicitamente nomeadas, consulte Controlando exceções e eventos.
Ambiente
| Modos | Modo de usuário, modo kernel |
| Destinos | Somente depuração dinâmica |
| Plataformas | Tudo |
Informações adicionais
Para obter mais informações sobre status de interrupção e manipulação de status, descrições de todos os códigos de evento, uma lista dos status padrão para todos os eventos e outros métodos de controle desse status, consulte Controlando exceções e eventos.
Comentários
O comando sx exibe a lista de exceções para o processo atual e a lista de todos os eventos sem exceção e exibe o comportamento padrão do depurador para cada exceção e evento.
Os comandos sxe, sxd, sxn e sxi controlam as configurações do depurador para cada exceção e evento.
O comando sxr redefine todos os estados de exceção e filtro de evento para as configurações padrão. Por exemplo, os comandos são limpos e interrompidos e as opções continuar são redefinidas para suas configurações padrão.
O comando sx- não altera o status de tratamento ou o status de interrupção da exceção ou evento especificado. Esse comando poderá ser usado se você quiser alterar o comando de primeira chance ou o comando de segunda chance associado a um evento específico, mas não quiser alterar mais nada.
Se você incluir a opção -h (ou se os eventos cc, hc, bpec ou ssec forem especificados), os comandossxe, sxd, sxn e sxi controlarão a manipulação status da exceção ou evento. Em todos os outros casos, esses comandos controlam a status de interrupção da exceção ou evento.
Quando você está definindo a status de interrupção, esses comandos têm os seguintes efeitos:
| Comando | Nome do status | Descrição |
|---|---|---|
| Sxe | Quebrar (Habilitado) |
Quando essa exceção ocorre, o destino é imediatamente dividido no depurador antes que outros manipuladores de erro sejam ativados. Esse tipo de tratamento é chamado de tratamento de primeira chance . |
| Sxd | Quebra de segunda chance (Desabilitado) |
O depurador não é interrompido para uma exceção de primeira chance desse tipo (embora uma mensagem seja exibida). Se outros manipuladores de erros não resolverem essa exceção, a execução será interrompida e o destino será interrompido no depurador. Esse tipo de tratamento é chamado de tratamento de segunda chance . |
| sxn | Saída (Notificar) |
Quando essa exceção ocorre, o aplicativo de destino não é dividido no depurador. No entanto, é exibida uma mensagem que notifica o usuário sobre essa exceção. |
| sxi | Ignorar | Quando essa exceção ocorre, o aplicativo de destino não é dividido no depurador e nenhuma mensagem é exibida. |
Quando você está definindo o tratamento status, esses comandos têm os seguintes efeitos:
| Comando | Nome do status | Descrição |
|---|---|---|
| Sxe | Tratado | O evento é considerado manipulado quando a execução é retomada. |
| sxd, sxn, sxi | Não tratado | O evento é considerado não tratado quando a execução é retomada. |
Você pode usar a opção -h junto com exceções, não eventos. Use essa opção com ch, bpe ou sse para definir o status de tratamento para hc, bpec ou ssec, respectivamente. Se você usar a opção -h com qualquer outro evento, ela não terá efeito.
Use as opções -c ou -c2 com hc, bpec ou ssec para associar os comandos especificados a ch, bpe ou sse, respectivamente.
No exemplo a seguir, o comando sxe é usado para definir a interrupção status de eventos de violação de acesso para interromper na primeira chance e para definir o comando de primeira chance que será executado nesse ponto como r eax. Em seguida, o comando sx- é usado para alterar o comando de primeira chance para r ebx, sem alterar a manipulação status. Por fim, uma parte da saída sx é mostrada, indicando as configurações atuais para eventos de violação de acesso:
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"
. . .