Interface ICorDebugStepper

Artigo
08/25/2010

Representa uma etapa na execução de código que é executada por um depurador, serve sistema autônomo um identificador entre a emissão e a conclusão de um comando e oferece uma maneira de cancelar uma etapa.

interface ICorDebugStepper : IUnknown {
        
    HRESULT Deactivate ();
        
    HRESULT IsActive (
        [out] BOOL      *pbActive
    );
        
    HRESULT SetInterceptMask (
        [in] CorDebugIntercept mask
    );
        
    HRESULT SetRangeIL (
        [in] BOOL       bIL
    );
                
    HRESULT SetUnmappedStopMask (
        [in] CorDebugUnmappedStop mask
    );
        
    HRESULT Step (
        [in] BOOL       bStepIn
    );
        
    HRESULT StepOut ();
        
    HRESULT StepRange (
        [in] BOOL       bStepIn,
        [in, size_is(cRangeCount)] COR_DEBUG_STEP_RANGE ranges[],
        [in] ULONG32    cRangeCount
    );

};

Métodos

Método	Descrição
Método ICorDebugStepper::Deactivate	Faz com que esse ICorDebugStepper Para cancelar o último comando de etapa recebido.
Método ICorDebugStepper::IsActive	Obtém um valor que indica se este ICorDebugStepper no momento está executando uma etapa.
Método ICorDebugStepper::SetInterceptMask	Define um CorDebugIntercept valor que especifica os tipos de código que ele são apresentado em.
Método ICorDebugStepper::SetRangeIL	Define um valor que indica se chamadas para ICorDebugStepper::StepRange passar valores de argumento em relação ao código nativo ou ao código Microsoft intermediate linguagem (MSIL) do método que ele está sendo apresentado em etapas.
Método ICorDebugStepper::SetUnmappedStopMask	Define um CorDebugUnmappedStop valor que especifica o tipo de código não mapeado em que a execução será interrompido.
Método ICorDebugStepper::Step	Faz com que esse ICorDebugStepper para a etapa única por meio de seu segmento contendo e, opcionalmente, para continuar a depuração único por meio das funções que são chamadas de dentro do thread.
Método ICorDebugStepper::StepOut	Faz com que esse ICorDebugStepper para a etapa única por meio de seu contendo thread e em Concluir quando o quadro corrente devolve o controle para o quadro de chamada.
Método ICorDebugStepper::StepRange	Faz com que esse ICorDebugStepper para a etapa única por meio de seu segmento que contém e para retornar quando ele atingir código além o último dos intervalos especificados.

Comentários

The ICorDebugStepper interface serve para as seguintes finalidades:

Ele atua sistema autônomo um identificador entre um comando de depuração é emitido e a conclusão de comando.
Ele fornece uma interface central para encapsular todas as etapas que pode ser executada.
Ele fornece uma maneira para cancelar uma operação de revisão prematuramente.

Pode haver mais de um seletor por thread. Por exemplo, um ponto de interrupção pode ser atingido durante a depuração através de uma função e o usuário talvez deseje iniciar uma nova operação revisão dentro dessa função. Ele é o depurador para determinar como lidar com essa situação. O depurador poderá cancelar a operação original de revisão ou aninhar duas operações. The ICorDebugStepper interface oferece suporte a duas opções.

Um seletor pode migrar entre threads se o common linguagem tempo de execução (CLR) faz uma telefonar cruzada segmentação, empacotada.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: CorDebug.idl

Biblioteca: CorGuids.lib

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Referência

Interface ICorDebugStepper2

Outros recursos

Interfaces de depuração

Compartilhar via