DkmStowedExceptionInformation.Create Method

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Exceptions
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmStowedExceptionInformation object instance.

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

public:
 static Microsoft::VisualStudio::Debugger::Exceptions::DkmStowedExceptionInformation ^ Create(int ResultCode, System::UInt32 ThreadId, System::String ^ ErrorText, System::UInt64 ExceptionAddress, System::UInt32 StackTraceWordSize, System::UInt32 StackTraceWords, System::UInt64 StackTrace, Microsoft::VisualStudio::Debugger::Exceptions::DkmStowedExceptionInformation::NestedException ^ NestedException);
 static Microsoft::VisualStudio::Debugger::Exceptions::DkmStowedExceptionInformation Create(int ResultCode, unsigned int ThreadId, std::wstring const & ErrorText, unsigned long ExceptionAddress, unsigned int StackTraceWordSize, unsigned int StackTraceWords, unsigned long StackTrace, Microsoft::VisualStudio::Debugger::Exceptions::DkmStowedExceptionInformation::NestedException const & NestedException);
public static Microsoft.VisualStudio.Debugger.Exceptions.DkmStowedExceptionInformation Create (int ResultCode, uint ThreadId, string ErrorText, ulong ExceptionAddress, uint StackTraceWordSize, uint StackTraceWords, ulong StackTrace, Microsoft.VisualStudio.Debugger.Exceptions.DkmStowedExceptionInformation.NestedException NestedException);
public static Microsoft.VisualStudio.Debugger.Exceptions.DkmStowedExceptionInformation Create (int ResultCode, uint ThreadId, string? ErrorText, ulong ExceptionAddress, uint StackTraceWordSize, uint StackTraceWords, ulong StackTrace, Microsoft.VisualStudio.Debugger.Exceptions.DkmStowedExceptionInformation.NestedException? NestedException);
static member Create : int * uint32 * string * uint64 * uint32 * uint32 * uint64 * Microsoft.VisualStudio.Debugger.Exceptions.DkmStowedExceptionInformation.NestedException -> Microsoft.VisualStudio.Debugger.Exceptions.DkmStowedExceptionInformation
Public Shared Function Create (ResultCode As Integer, ThreadId As UInteger, ErrorText As String, ExceptionAddress As ULong, StackTraceWordSize As UInteger, StackTraceWords As UInteger, StackTrace As ULong, NestedException As DkmStowedExceptionInformation.NestedException) As DkmStowedExceptionInformation

Parameters

ResultCode
Int32

[In] The HRESULT of the original thrown exception.

ThreadId
UInt32

[In] The ID of the thread that the exception was thrown on. This is just an ID and not a DkmThread because the thread may have exited before the dump is taken.

ErrorText
String

[In,Optional] The error text from the Stowed Exception. If this is non null, it is a Text Stowed Exception (as opposed to binary), and the ExceptionAddress, StackTraceWordSize, StackTraceWords, and StackTrace fields will be invalid.

ExceptionAddress
UInt64

[In] The address of the exception.

StackTraceWordSize
UInt32

[In] Size, in bytes, of each word in the stack trace that the StackTrace member points to. This value is set to 4 for 32-bit platforms and 8 for 64-bit platforms.

StackTraceWords
UInt32

[In] The number of words in the stack trace that the StackTrace member points to. The number of words is equal to the number of elements in the array.

StackTrace
UInt64

[In] A pointer to a memory block that contains the stack trace.

NestedException
DkmStowedExceptionInformation.NestedException

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

Returns

DkmStowedExceptionInformation

[Out] Result of this method call.

Applies to