DkmCustomExceptionInformation Classe

Definição

Fornece informações sobre uma exceção que foi gerada no processo de destino. As exceções personalizadas são usadas para verificações de tempo de execução do C++, falhas do assistente de depuração gerenciada e exceções de tempos de execução de terceiros.

public ref class DkmCustomExceptionInformation : Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionInformation
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmCustomExceptionInformation : Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionInformation
[Windows::Foundation::Metadata::WebHostHidden]
class DkmCustomExceptionInformation : Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionInformation
[System.Runtime.InteropServices.Guid("7572c08d-ef31-438a-9324-21d72ad99c65")]
public class DkmCustomExceptionInformation : Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionInformation
[<System.Runtime.InteropServices.Guid("7572c08d-ef31-438a-9324-21d72ad99c65")>]
type DkmCustomExceptionInformation = class
    inherit DkmExceptionInformation
Public Class DkmCustomExceptionInformation
Inherits DkmExceptionInformation
Herança
DkmCustomExceptionInformation
Atributos

Propriedades

AdditionalInformation

Adicional Dados adicionais sobre esta exceção personalizada. O formato é definido pelo tipo de exceção personalizada.

Code

código inteiro de 32 bits para a exceção. Para exceções Win32, esse é o código passado para RaiseException (ex: EXCEPTION_ACCESS_VIOLATION). Esse valor é zero para categorias de exceção que identificam exceções por cadeia de caracteres (ex: CLR).

(Herdado de DkmExceptionInformation)
ExceptionCategory

Indica o tipo de exceção.

(Herdado de DkmExceptionInformation)
ImplementationException

Adicional Informações sobre a exceção subjacente usada para implementar uma exceção de nível superior. Por exemplo, exceções CLR e C++ podem ser implementadas sobre as exceções Win32. Portanto, isso pode armazenar o DkmWin32ExceptionInformation para exceções CLR ou C++.

(Herdado de DkmExceptionInformation)
InstructionAddress

Adicional Endereço onde a exceção ocorreu. Isso sempre estará presente para exceções de C++ e Win32. Pode estar faltando em exceções CLR ou MDAs, pois elas podem se originar de dentro do tempo de execução.

(Herdado de DkmExceptionInformation)
Name

Adicional Nome da exceção. Para exceções de C++ ou CLR, esse é o nome do tipo. Esse valor será NULL para categorias de exceção que identificam exceções por código (ex: Win32).

(Herdado de DkmExceptionInformation)
Process

DkmProcess representa um processo de destino que está sendo depurado. O depurador debugs processa, portanto, essa é a unidade básica de depuração. Um DkmProcess pode representar um processo do sistema ou um processo virtual, como minidespejos.

(Herdado de DkmExceptionInformation)
ProcessingStage

O depurador recebe notificações do processo de destino em vários estágios dentro do processamento de exceção (ex: exceção gerada, exceção sem tratamento). Essa enumeração indica os estágios de uma notificação.

(Herdado de DkmExceptionInformation)
RuntimeInstance

A classe DkmRuntimeInstance representa um ambiente de execução que é carregado em um DkmProcess e que contém o código a ser depurado.

(Herdado de DkmExceptionInformation)
TagValue

DkmExceptionInformation é uma classe base abstrata. Essa enumeração indica a qual classe derivada esse objeto é uma instância do.

(Herdado de DkmExceptionInformation)
Thread

DkmThread representa um thread em execução no processo de destino.

(Herdado de DkmExceptionInformation)

Métodos

CanModifyProcessing()

Determina se o processamento para essa exceção pode ser modificado pelo depurador. Por exemplo, se esse usuário tiver executado uma ação (como Set Next Statement) que exigia que a exceção fosse restringida implicitamente, isso pode retornar false. Esse método também pode retornar false se o tempo de execução não permitir que a exceção seja descomprimida.

(Herdado de DkmExceptionInformation)
Create(DkmRuntimeInstance, Guid, DkmThread, DkmInstructionAddress, String, UInt32, DkmExceptionProcessingStage, DkmExceptionInformation, ReadOnlyCollection<Byte>)

Crie uma nova instância do objeto DkmCustomExceptionInformation.

GetAdditionalInformation()

Fornece informações adicionais sobre uma exceção que será exibida quando o Visual Studio parar na exceção. Para exceções CLR, ela contém a propriedade ' message ' do System. Exception que foi lançada.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmExceptionInformation)
GetDescription()

Fornece uma descrição de cadeia de caracteres para uma exceção. Isso é usado ao rastrear a exceção para a janela de saída.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmExceptionInformation)
GetExceptionDetails(DkmInspectionSession)

Obtenha os detalhes da exceção para esta exceção.

         Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion. VS15RTM).
(Herdado de DkmExceptionInformation)
GetExceptionStackTrace()

Obtém o rastreamento de pilha capturado associado à exceção, se houver uma disponível.

Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion. VS12RTM).

(Herdado de DkmExceptionInformation)
GetWinRTErrorInfo(String, String, String)

Fornece informações adicionais orientadas ao desenvolvedor sobre a exceção. Essas informações devem ser exibidas junto com GetDescription e GetAdditionalInformation para esclarecer a causa do erro.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmExceptionInformation)
OnContinued()

Gerar um evento ExceptionContinued. Os componentes que implementam a interface do coletor de eventos receberão a notificação de eventos. O controle retornará assim que todos os componentes forem notificados.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmExceptionInformation)
OnDebugMonitorException()

Gerar um evento DebugMonitorException. Os componentes que implementam a interface do coletor de eventos receberão a notificação de eventos. O controle retornará assim que todos os componentes forem notificados.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmExceptionInformation)
OnOutOfBandException()

Gerar um evento OutOfBandException. Os componentes que implementam a interface do coletor de eventos receberão a notificação de eventos. O controle retornará assim que todos os componentes forem notificados.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

Essa API foi introduzida no Visual Studio 11 atualização 1 (DkmApiVersion. VS11FeaturePack1).

(Herdado de DkmExceptionInformation)
SquashProcessing()

Atualiza o estado do processo de destino para que, quando a execução for retomada, o processo de destino não continue o processamento de exceção padrão (ex: pesquisa de manipulador, desenrolamento de pilha). Esse método precisa ser chamado antes de continuar a execução.

(Herdado de DkmExceptionInformation)

Aplica-se a