DkmExceptionTriggerHit Class

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Exceptions

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

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

public ref class DkmExceptionTriggerHit

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmExceptionTriggerHit

[Windows::Foundation::Metadata::WebHostHidden]
class DkmExceptionTriggerHit

[System.Runtime.InteropServices.Guid("4d7aee60-dc8d-794c-98c2-7f4704eeb5d1")]
public class DkmExceptionTriggerHit

[<System.Runtime.InteropServices.Guid("4d7aee60-dc8d-794c-98c2-7f4704eeb5d1")>]
type DkmExceptionTriggerHit = class

Public Class DkmExceptionTriggerHit

Inheritance

Object

DkmExceptionTriggerHit

Attributes

GuidAttribute

Properties

AdditionalInformation	[Optional] Optional additional information about this exception. For CLR exceptions, this contains the 'Message' property from the System.Exception which was thrown. This information is obtained from IDkmExceptionFormatter.GetAdditionalInformation.
CapabilitySid	[Optional] Specifies the missing capability if there is one which resulted in a runtime exception.
Description	Description string for the exception. This is obtained from IDkmExceptionFormatter.GetDescription.
Exception	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.
ExceptionConditionInfo	[Optional] Exception condition information. This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
Process	DkmProcess represents a target process which is being debugged. The debugger debugs processes, so this is the basic unit of debugging. A DkmProcess can represent a system process or a virtual process such as minidumps.
RestrictedErrorDescription	[Optional] Optional WinRT Restricted Description for the error, obtained from the IDkmExceptionFormatterCallback.GetRestrictedErrorInfo.
RestrictedReference	[Optional] Specifies the restricted reference. This is provided instead of the RestrictedDescription and any CapabilitySid. A scenario for this is when the debuggee process is not running in same session as debugger process. Components above will need to use this to work out the restricted description and any missing capability.
RuntimeInstance	The DkmRuntimeInstance class represents an execution environment which is loaded into a DkmProcess and which contains code to be debugged.
SourceId	Identifies the source of an object. SourceIds are used to enable filtering in scenarios when multiple components may be creating instances of a class. For example, source ids can be used to determine if a breakpoint comes from the AD7 AL (ex: user breakpoint, or other breakpoint visible at the SDM level) instead of a breakpoint which may be created by another component (for example an internal breakpoint used for stepping).
StackTrace	[Optional] The stack trace of the exception, if available. This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Thread	DkmThread represents a thread running in the target process.

Methods

Create(DkmExceptionInformation, String, String, String, String, String, Guid)	Create a new DkmExceptionTriggerHit object instance.
Create(DkmExceptionInformation, String, String, String, String, String, Guid, ReadOnlyCollection<DkmInstructionAddress>)	Create a new DkmExceptionTriggerHit object instance. This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmExceptionInformation, String, String, String, String, String, Guid, ReadOnlyCollection<DkmInstructionAddress>, ReadOnlyCollection<DkmExceptionConditionInfo>)	Create a new DkmExceptionTriggerHit object instance. This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
Send()	Raise a ExceptionTriggerHit event. Components which implement the event sink interface will receive the event notification. This method will enqueue the event and control will immediately return to the caller.
TryGetAnalyzedDescription()	Tries to get a detailed information about the source of the problem. Location constraint: API must be called from an IDE component (component level > 100,000). This API was introduced in Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1).