Share via


DkmExceptionNameTrigger Class

Definition

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).

public ref class DkmExceptionNameTrigger : Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionTrigger
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmExceptionNameTrigger : Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionTrigger
[Windows::Foundation::Metadata::WebHostHidden]
class DkmExceptionNameTrigger : Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionTrigger
[System.Runtime.InteropServices.Guid("dcffa6ae-e45d-fd4f-a23e-82779a332801")]
public class DkmExceptionNameTrigger : Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionTrigger
[<System.Runtime.InteropServices.Guid("dcffa6ae-e45d-fd4f-a23e-82779a332801")>]
type DkmExceptionNameTrigger = class
    inherit DkmExceptionTrigger
Public Class DkmExceptionNameTrigger
Inherits DkmExceptionTrigger
Inheritance
DkmExceptionNameTrigger
Attributes

Properties

ExceptionCategory

Indicates the type of exception.

ExceptionConditionInfo

[Optional] Exception condition information.

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

(Inherited from DkmExceptionTrigger)
Name

Name of the exception. For C++ or CLR exceptions, this is the type name. This value will be null for exception categories that identify exceptions by code (ex: Win32 exceptions).

ProcessingStage

The debugger receives notifications from the target process at various stages within exception processing (ex: exception thrown, exception unhandled). This enumeration is a bit mask of which of these stages the trigger should fire for.

(Inherited from DkmExceptionTrigger)
TagValue

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

(Inherited from DkmExceptionTrigger)
Thread

[Optional] Thread on which this trigger applies. If null, the trigger will be examined for all threads.

(Inherited from DkmExceptionTrigger)

Methods

Create(DkmExceptionProcessingStage, DkmThread, Guid, String)

Create a new DkmExceptionNameTrigger object instance.

Create(DkmExceptionProcessingStage, DkmThread, ReadOnlyCollection<DkmExceptionConditionInfo>, Guid, String)

Create a new DkmExceptionNameTrigger object instance.

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

Applies to