ICorDebugEval::CreateValue Method
Creates a value of the specified type, with an initial value of zero or null.
This method is obsolete in .NET Framework version 2.0. Use ICorDebugEval2::CreateValueForType instead.
Syntax
HRESULT CreateValue (
[in] CorElementType elementType,
[in] ICorDebugClass *pElementClass,
[out] ICorDebugValue **ppValue
);
Parameters
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.
Remarks
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.
Requirements
Platforms: See System Requirements.
Header: CorDebug.idl, CorDebug.h
Library: CorGuids.lib
.NET Framework Versions: 1.1, 1.0