Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ICorDebugEval::CreateValue Method

Creates a value of the specified type, with an initial value of zero or null.

This method is obsolete in the .NET Framework version 2.0. Use ICorDebugEval2::CreateValueForType instead.

HRESULT CreateValue (
    [in] CorElementType     elementType,
    [in] ICorDebugClass     *pElementClass,
    [out] ICorDebugValue    **ppValue
);
elementType

[in] A value of the CorElementType enumeration that specifies the type of the value.

pElementClass

[in] Pointer to an ICorDebugClass object that specifies the class of the value, if the type is not a primitive type.

ppValue

[out] Pointer to the address of an ICorDebugValue object that represents the value.

CreateValue creates an ICorDebugValue object of the given type for the sole purpose of using it in a function evaluation. This value object can be used to pass user constants as parameters.

If the type of the value is a primitive type, its initial value is zero or null. Use ICorDebugGenericValue::SetValue to set the value of a primitive type.

If the value of elementType is ELEMENT_TYPE_CLASS, you get an ICorDebugReferenceValue (returned in ppValue) representing the null object reference. You can use this object to pass null to a function evaluation that has object reference parameters. You cannot set the ICorDebugValue to anything; it always remains null.

Platforms: See .NET Framework System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: 1.1, 1.0

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.