ICorDebugStepper Interface
Representa uma etapa na execução de código que é executada por um depurador, serve como um identificador entre a emissão e a conclusão de um comando e fornece uma maneira de cancelar uma etapa.
Métodos
| Método | Description |
|---|---|
| Método Deactivate | Faz com que isso ICorDebugStepper cancele o comando da última etapa que recebeu. |
| Método IsActive | Obtém um valor que indica se isso ICorDebugStepper está executando uma etapa no momento. |
| Método SetInterceptMask | Define um valor CorDebugIntercept que especifica os tipos de código que são escalonados. |
| Método SetRangeIL | Define um valor que indica se as chamadas para ICorDebugStepper::StepRange passam valores de argumento relativos ao código nativo ou ao código de linguagem intermediária comum (CIL) do método que está sendo percorrido. |
| Método SetUnmappedStopMask | Define um valor CorDebugUnmappedStop que especifica o tipo de código não mapeado no qual a execução será interrompida. |
| Método Step | Faz com que isso ICorDebugStepper passe por um único passo através de seu thread de contenção e, opcionalmente, continue com uma única etapa através de funções que são chamadas dentro do thread. |
| Método StepOut | Faz com que isso ICorDebugStepper passe por um único passo através de seu thread de contenção e seja concluído quando o quadro atual retornar o controle para o quadro chamador. |
| Método StepRange | Faz com que isso ICorDebugStepper passe por um único passo através de seu thread de contenção e retorne quando atingir o código além do último dos intervalos especificados. |
Observações
A ICorDebugStepper interface serve os seguintes propósitos:
Ele atua como um identificador entre um comando step que é emitido e a conclusão desse comando.
Ele fornece uma interface central para encapsular todas as etapas que podem ser executadas.
Ele fornece uma maneira de cancelar prematuramente uma operação de revisão.
Pode haver mais de um passo por thread. Por exemplo, um ponto de interrupção pode ser atingido ao passar por cima de uma função, e o usuário pode desejar iniciar uma nova operação de revisão dentro dessa função. Cabe ao depurador determinar como lidar com essa situação. O depurador pode querer cancelar a operação de revisão original ou aninhar as duas operações. A ICorDebugStepper interface suporta ambas as opções.
Um stepper pode migrar entre threads se o Common Language Runtime (CLR) fizer uma chamada cruzada e empacotada.
Nota
Esta interface não suporta ser chamada remotamente, seja entre máquinas ou entre processos.
Requisitos
Plataformas: Consulte Requisitos do sistema.
Cabeçalho: CorDebug.idl, CorDebug.h
Biblioteca: CorGuids.lib
Versões do .NET Framework: Disponível desde 1.0
