DkmClrValue.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Create a new DkmClrValue object instance.
Location constraint: API must be called from a Monitor component (component level < 100,000).
This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
public:
static Microsoft::VisualStudio::Debugger::Evaluation::ClrCompilation::DkmClrValue ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionSession ^ InspectionSession, Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguage ^ Language, Microsoft::VisualStudio::Debugger::Clr::DkmClrType ^ Type, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultCategory Category, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultAccessType Access, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultStorageType StorageType, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, System::Object ^ HostObjectValue, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultFlags EvalFlags, Microsoft::VisualStudio::Debugger::Evaluation::DkmClrValueFlags ValueFlags, System::UInt64 NativeComPointer, Microsoft::VisualStudio::Debugger::Evaluation::DkmDataAddress ^ Address, System::String ^ Alias, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ ArrayDimensions, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ ArrayLowerBounds, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage Language, Microsoft.VisualStudio.Debugger.Clr.DkmClrType Type, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType StorageType, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, object HostObjectValue, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags EvalFlags, Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags ValueFlags, ulong NativeComPointer, Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress Address, string Alias, System.Collections.ObjectModel.ReadOnlyCollection<int> ArrayDimensions, System.Collections.ObjectModel.ReadOnlyCollection<int> ArrayLowerBounds, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage Language, Microsoft.VisualStudio.Debugger.Clr.DkmClrType? Type, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType StorageType, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, object? HostObjectValue, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags EvalFlags, Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags ValueFlags, ulong NativeComPointer, Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress? Address, string? Alias, System.Collections.ObjectModel.ReadOnlyCollection<int>? ArrayDimensions, System.Collections.ObjectModel.ReadOnlyCollection<int>? ArrayLowerBounds, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession * Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage * Microsoft.VisualStudio.Debugger.Clr.DkmClrType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags * bool * obj * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags * Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags * uint64 * Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress * string * System.Collections.ObjectModel.ReadOnlyCollection<int> * System.Collections.ObjectModel.ReadOnlyCollection<int> * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue
Public Shared Function Create (InspectionSession As DkmInspectionSession, Language As DkmLanguage, Type As DkmClrType, Category As DkmEvaluationResultCategory, Access As DkmEvaluationResultAccessType, StorageType As DkmEvaluationResultStorageType, TypeModifierFlags As DkmEvaluationResultTypeModifierFlags, IsNull As Boolean, HostObjectValue As Object, StackFrame As DkmStackWalkFrame, EvalFlags As DkmEvaluationResultFlags, ValueFlags As DkmClrValueFlags, NativeComPointer As ULong, Address As DkmDataAddress, Alias As String, ArrayDimensions As ReadOnlyCollection(Of Integer), ArrayLowerBounds As ReadOnlyCollection(Of Integer), DataItem As DkmDataItem) As DkmClrValue
Parameters
- InspectionSession
- DkmInspectionSession
[In] The InspectionSession allows the various components which examine data in the target process to store private data with the same lifetime. Inspection sessions are closed when the user attempts to continue the process.
- Language
- DkmLanguage
[In] The language being used.
- Type
- DkmClrType
[In,Optional] The runtime type of this node. System.String, for example. This value is null when the value is invalid AND the type cannot be determined.
- Category
- DkmEvaluationResultCategory
[In] The category (ex: Data, Method, etc) of this evaluation result.
[In] The access control level (public, private, etc) of the evaluation result.
- StorageType
- DkmEvaluationResultStorageType
[In] The storage type (ex: static) of the evaluation result.
- TypeModifierFlags
- DkmEvaluationResultTypeModifierFlags
[In] Type modifier flags (ex: const) of the evaluation result.
- IsNull
- Boolean
[In] True if the value is a null (or if there is no value).
- HostObjectValue
- Object
[In,Optional] The value of this node if the DkmClrValue is a value that can be represented in the debugger process. If the DkmClrValue is of a complex type, this value will be null. Note for usage in native code when the underlying value is a string: If you are consuming this field in native code, the VARIANT structure may be BSTR or an IUnknown that should be queried for IDkmManagedStringRef. If you are creating this field in native code, use a VARIANT of a BSTR.
- StackFrame
- DkmStackWalkFrame
[In] The stack frame used as the inspection frame of the interpreted expression.
- EvalFlags
- DkmEvaluationResultFlags
[In] Flags describing of the result of the evaluation that created this DkmClrValue.
- ValueFlags
- DkmClrValueFlags
[In] Flags describing this value.
- NativeComPointer
- UInt64
[In] An interface pointer to the native COM object if this value is an RCW.
- Address
- DkmDataAddress
[In,Optional] If the result is an address (i.e. the address flag is set in Flags), specifies the location of the backing value. This is used when the evaluation result is used as the input to the memory window or disassembly window. If it is an instruction address then it must have the CPUInstruction address set.
- Alias
- String
[In,Optional] The alias for this value. If the object has not been assigned an alias, this value will be null.
- ArrayDimensions
- ReadOnlyCollection<Int32>
[In,Optional] The dimensions of the the array. This value is only valid if this DkmClrValue is an array value.
- ArrayLowerBounds
- ReadOnlyCollection<Int32>
[In,Optional] The lower bounds of the the array. This value is only valid if this DkmClrValue is an array value.
- DataItem
- DkmDataItem
[In,Optional] Data object to add to the new DkmClrValue instance. Pass 'null' in the case that the caller doesn't need to add a data item.
Returns
[Out] Result of this method call.