Microsoft.VisualStudio.Debugger.Exceptions Namespace

Classes

DkmExceptionCategory

Indicates the type of exception.

DkmExceptionCategoryTrigger

Describes an entire category (ex: .NET exceptions, Win32 exceptions) that a component wants to break on.

DkmExceptionCodeTrigger

Describe an exception that a component wants to break on by its exception code. Code triggers are used for exception categories which use exception codes to identify exceptions (ex: Win32 exceptions). Code triggers will not fire for exception categories which use a name string to identify exceptions (ex: CLR exceptions).

DkmExceptionConditionInfo

Defines a single exception condition, see DkmExceptionTrigger.ExceptionConditionInfo on setting multiple exception conditions.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

DkmExceptionDetails

Contains details about an exception or inner exception object.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

DkmExceptionGlobalTrigger

An exception trigger which will fire regardless of exception category, exception name, or exception code. Thus, this type of exception trigger can only be conditioned based on processing stage or thread.

DkmExceptionInformation

Provides information about an exception which was raised in the target process. This information includes details of what exception was raised and the current stage of exception processing.

Derived classes: DkmClrExceptionInformation, DkmCppExceptionInformation, DkmCustomExceptionInformation, DkmGPUMemoryAccessExceptionInformation, DkmWin32ExceptionInformation

DkmExceptionNameTrigger

Describes an exception that a component wants to break on by its name. NameTriggers are used for exception categories that use names to identify exceptions. For example, CLR exceptions and C++ exceptions are identified by type name. Name triggers will not fire for code-based exception categories (ex: Win32 exceptions).

DkmExceptionTrigger

Describes an exception or collection of exceptions which a component wants to break on. When a higher level components wants to be notified about certain exceptions, it should create one or more exception triggers, and then enable these triggers (DkmProcess.EnableExceptionTriggers). After this, when the exception occurs, a ExceptionTriggerHit exception will be fired whenever this trigger is met.

Derived classes: DkmExceptionCategoryTrigger, DkmExceptionCodeTrigger, DkmExceptionGlobalTrigger, DkmExceptionNameTrigger

DkmExceptionTriggerHit

Provides information about an exception trigger which was satisfied (hit) by an exception coming from the target process.

DkmStowedExceptionInformation

Provides information about a stowed exception. In modern apps, when an exception is thrown, it is caught by COM Interop and another exception is thrown by the framework. The original exception is captured as a stowed exception.

This API was introduced in Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).

DkmStowedExceptionInformation.NestedException

Stowed Exceptions can contain a nested exception. If this is non-null, the Stowed exception contains additional information in the NestedException.

This API was introduced in Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).

Structs

DkmAddExceptionTriggerAsyncResult

Result of an asynchronous DkmProcess.AddExceptionTrigger call.

DkmRemoveExceptionTriggerAsyncResult

Result of an asynchronous DkmProcess.RemoveExceptionTrigger call.

Enums

DkmExceptionInformation.Tag

DkmExceptionInformation is an abstract base class. This enum indicates which derived class this object is an instance of.

DkmExceptionInterceptActionFlags

Specifies exception interception actions.

DkmExceptionProcessingStage

The debugger receives notifications from the target process at various stages within exception processing (ex: exception thrown, exception unhandled). This enumeration indicates the stage(s) for a notification.

DkmExceptionTrigger.Tag

DkmExceptionTrigger is an abstract base class. This enum indicates which derived class this object is an instance of.

DkmStowedExceptionNestedType

DkmStowedExceptionNestedType describes the type of DkmStowedExceptionInformation.NestedException.NestedExceptionAddress.

This API was introduced in Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).