DkmCppExceptionInformation.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Native

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmCppExceptionInformation object instance.

public:
 static Microsoft::VisualStudio::Debugger::Native::DkmCppExceptionInformation ^ Create(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ InstructionAddress, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionProcessingStage ProcessingStage, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionInformation ^ ImplementationException, System::String ^ Name, System::UInt64 ExceptionObjectPointer, System::UInt64 Address, Microsoft::VisualStudio::Debugger::Native::DkmCppWinRTExceptionInformation ^ WinRTExceptionInfo);

public static Microsoft.VisualStudio.Debugger.Native.DkmCppExceptionInformation Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? InstructionAddress, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage ProcessingStage, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionInformation? ImplementationException, string Name, ulong ExceptionObjectPointer, ulong Address, Microsoft.VisualStudio.Debugger.Native.DkmCppWinRTExceptionInformation? WinRTExceptionInfo);

static member Create : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionProcessingStage * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionInformation * string * uint64 * uint64 * Microsoft.VisualStudio.Debugger.Native.DkmCppWinRTExceptionInformation -> Microsoft.VisualStudio.Debugger.Native.DkmCppExceptionInformation

Public Shared Function Create (RuntimeInstance As DkmRuntimeInstance, Thread As DkmThread, InstructionAddress As DkmInstructionAddress, ProcessingStage As DkmExceptionProcessingStage, ImplementationException As DkmExceptionInformation, Name As String, ExceptionObjectPointer As ULong, Address As ULong, WinRTExceptionInfo As DkmCppWinRTExceptionInformation) As DkmCppExceptionInformation

Parameters

RuntimeInstance

DkmRuntimeInstance

[In] The DkmRuntimeInstance class represents an execution environment which is loaded into a DkmProcess and which contains code to be debugged.

Thread

DkmThread

[In] DkmThread represents a thread running in the target process.

InstructionAddress

DkmInstructionAddress

[In,Optional] Address where the exception occurred. This will always be present for C++ and Win32 exceptions. It may be missing from CLR exceptions or MDAs as these may originate from inside the runtime.

ProcessingStage

DkmExceptionProcessingStage

[In] 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.

ImplementationException

DkmExceptionInformation

[In,Optional] Information about the underlying exception used to implement a higher level exception. For example, CLR and C++ exceptions may be implemented on top of Win32 exceptions. So this may store the DkmWin32ExceptionInformation for CLR or C++ exceptions.

Name

String

[In] Type name of the exception. Example: 'std::exception'.

ExceptionObjectPointer

UInt64

[In] Address within the target process of the thrown object.

Address

UInt64

[In] The address where the exception occurred.

WinRTExceptionInfo

DkmCppWinRTExceptionInformation

[In,Optional] Extended information about a WinRT exception if it exists.

Returns

DkmCppExceptionInformation

[Out] Result of this method call.