CorDebugInterfaceVersion Enumeration

Article
02/04/2013

Specifies an interface, a version of the .NET Framework, or a version of the .NET Framework in which an interface was introduced.

typedef enum CorDebugInterfaceVersion {

    CorDebugInvalidVersion            = 0,
    CorDebugVersion_1_0               = CorDebugInvalidVersion + 1,

    ver_ICorDebugManagedCallback      = CorDebugVersion_1_0,
    ver_ICorDebugUnmanagedCallback    = CorDebugVersion_1_0,
    ver_ICorDebug                     = CorDebugVersion_1_0,
    ver_ICorDebugController           = CorDebugVersion_1_0,
    ver_ICorDebugAppDomain            = CorDebugVersion_1_0,
    ver_ICorDebugAssembly             = CorDebugVersion_1_0,
    ver_ICorDebugProcess              = CorDebugVersion_1_0,
    ver_ICorDebugBreakpoint           = CorDebugVersion_1_0,
    ver_ICorDebugFunctionBreakpoint   = CorDebugVersion_1_0,
    ver_ICorDebugModuleBreakpoint     = CorDebugVersion_1_0,
    ver_ICorDebugValueBreakpoint      = CorDebugVersion_1_0,
    ver_ICorDebugStepper              = CorDebugVersion_1_0,
    ver_ICorDebugRegisterSet          = CorDebugVersion_1_0,
    ver_ICorDebugThread               = CorDebugVersion_1_0,
    ver_ICorDebugChain                = CorDebugVersion_1_0,
    ver_ICorDebugFrame                = CorDebugVersion_1_0,
    ver_ICorDebugILFrame              = CorDebugVersion_1_0,
    ver_ICorDebugNativeFrame          = CorDebugVersion_1_0,
    ver_ICorDebugModule               = CorDebugVersion_1_0,
    ver_ICorDebugFunction             = CorDebugVersion_1_0,
    ver_ICorDebugCode                 = CorDebugVersion_1_0,
    ver_ICorDebugClass                = CorDebugVersion_1_0,
    ver_ICorDebugEval                 = CorDebugVersion_1_0,
    ver_ICorDebugValue                = CorDebugVersion_1_0,
    ver_ICorDebugGenericValue         = CorDebugVersion_1_0,
    ver_ICorDebugReferenceValue       = CorDebugVersion_1_0,
    ver_ICorDebugHeapValue            = CorDebugVersion_1_0,
    ver_ICorDebugObjectValue          = CorDebugVersion_1_0,
    ver_ICorDebugBoxValue             = CorDebugVersion_1_0,
    ver_ICorDebugStringValue          = CorDebugVersion_1_0,
    ver_ICorDebugArrayValue           = CorDebugVersion_1_0,
    ver_ICorDebugContext              = CorDebugVersion_1_0,
    ver_ICorDebugEnum                 = CorDebugVersion_1_0,
    ver_ICorDebugObjectEnum           = CorDebugVersion_1_0,
    ver_ICorDebugBreakpointEnum       = CorDebugVersion_1_0,
    ver_ICorDebugStepperEnum          = CorDebugVersion_1_0,
    ver_ICorDebugProcessEnum          = CorDebugVersion_1_0,
    ver_ICorDebugThreadEnum           = CorDebugVersion_1_0,
    ver_ICorDebugFrameEnum            = CorDebugVersion_1_0,
    ver_ICorDebugChainEnum            = CorDebugVersion_1_0,
    ver_ICorDebugModuleEnum           = CorDebugVersion_1_0,
    ver_ICorDebugValueEnum            = CorDebugVersion_1_0,
    ver_ICorDebugCodeEnum             = CorDebugVersion_1_0,
    ver_ICorDebugTypeEnum             = CorDebugVersion_1_0,
    ver_ICorDebugErrorInfoEnum        = CorDebugVersion_1_0,
    ver_ICorDebugAppDomainEnum        = CorDebugVersion_1_0,
    ver_ICorDebugAssemblyEnum         = CorDebugVersion_1_0,
    ver_ICorDebugEditAndContinueErrorInfo 
                                      = CorDebugVersion_1_0,
    ver_ICorDebugEditAndContinueSnapshot 
                                      = CorDebugVersion_1_0,
    
    CorDebugVersion_1_1               = CorDebugVersion_1_0 + 1,
    // No interface definitions in version 1.1.
    
    CorDebugVersion_2_0 = CorDebugVersion_1_1 + 1,
    
    ver_ICorDebugManagedCallback2    = CorDebugVersion_2_0,
    ver_ICorDebugAppDomain2          = CorDebugVersion_2_0,
    ver_ICorDebugProcess2            = CorDebugVersion_2_0,
    ver_ICorDebugStepper2            = CorDebugVersion_2_0,
    ver_ICorDebugRegisterSet2        = CorDebugVersion_2_0,
    ver_ICorDebugThread2             = CorDebugVersion_2_0,
    ver_ICorDebugILFrame2            = CorDebugVersion_2_0,
    ver_ICorDebugModule2             = CorDebugVersion_2_0,
    ver_ICorDebugFunction2           = CorDebugVersion_2_0,
    ver_ICorDebugCode2               = CorDebugVersion_2_0,
    ver_ICorDebugClass2              = CorDebugVersion_2_0,
    ver_ICorDebugValue2              = CorDebugVersion_2_0,
    ver_ICorDebugEval2               = CorDebugVersion_2_0,
    ver_ICorDebugObjectValue2        = CorDebugVersion_2_0,
    
    CorDebugVersion_3_0 = CorDebugVersion_2_0 + 1,

    ver_ICorDebugThread3             = CorDebugVersion_3_0,
    ver_ICorDebugThread4             = CorDebugVersion_3_0,
    ver_ICorDebugStackWalk           = CorDebugVersion_3_0,
    ver_ICorDebugNativeFrame2        = CorDebugVersion_3_0,
    ver_ICorDebugInternalFrame2      = CorDebugVersion_3_0,
    ver_ICorDebugRuntimeUnwindableFrame = CorDebugVersion_3_0,
    ver_ICorDebugHeapValue3          = CorDebugVersion_3_0,
    ver_ICorDebugBlockingObjectEnum  = CorDebugVersion_3_0,

    CorDebugLatestVersion = CorDebugVersion_3_0

    
} CorDebugInterfaceVersion;

Members

The following table provides links from each enumeration value to the corresponding interface. In addition, the table indicates the first version of the .NET Framework that the interface was supported in.

Member	Specifies	.NET Framework version
CorDebugInvalidVersion	The version of the .NET Framework is invalid.	-
CorDebugVersion_1_0	The version of the .NET Framework, including all its service packs, is 1.0.	1.0
ver_ICorDebugManagedCallback	ICorDebugManagedCallback	1.0
ver_ICorDebugUnmanagedCallback	ICorDebugUnmanagedCallback	1.0
ver_ICorDebug	ICorDebug	1.0
ver_ICorDebugController	ICorDebugController	1.0
ver_ICorDebugAppDomain	ICorDebugAppDomain	1.0
ver_ICorDebugAssembly	ICorDebugAssembly	1.0
ver_ICorDebugProcess	ICorDebugProcess	1.0
ver_ICorDebugBreakpoint	ICorDebugBreakpoint	1.0
ver_ICorDebugFunctionBreakpoint	ICorDebugFunctionBreakpoint	1.0
ver_ICorDebugModuleBreakpoint	ICorDebugModuleBreakpoint	1.0
ver_ICorDebugValueBreakpoint	ICorDebugValueBreakpoint	1.0
ver_ICorDebugStepper	ICorDebugStepper	1.0
ver_ICorDebugRegisterSet	ICorDebugRegisterSet	1.0
ver_ICorDebugThread	ICorDebugThread	1.0
ver_ICorDebugChain	ICorDebugChain	1.0
ver_ICorDebugFrame	ICorDebugFrame	1.0
ver_ICorDebugILFrame	ICorDebugILFrame	1.0
ver_ICorDebugNativeFrame	ICorDebugNativeFrame	1.0
ver_ICorDebugModule	ICorDebugModule	1.0
ver_ICorDebugFunction	ICorDebugFunction	1.0
ver_ICorDebugCode	ICorDebugCode	1.0
ver_ICorDebugClass	ICorDebugClass	1.0
ver_ICorDebugEval	ICorDebugEval	1.0
ver_ICorDebugValue	ICorDebugValue	1.0
ver_ICorDebugGenericValue	ICorDebugGenericValue	1.0
ver_ICorDebugReferenceValue	ICorDebugReferenceValue	1.0
ver_ICorDebugHeapValue	ICorDebugHeapValue	1.0
ver_ICorDebugObjectValue	ICorDebugObjectValue	1.0
ver_ICorDebugBoxValue	ICorDebugBoxValue	1.0
ver_ICorDebugStringValue	ICorDebugStringValue	1.0
ver_ICorDebugArrayValue	ICorDebugArrayValue	1.0
ver_ICorDebugContext	ICorDebugContext	1.0
ver_ICorDebugEnum	ICorDebugEnum	1.0
ver_ICorDebugObjectEnum	ICorDebugObjectEnum	1.0
ver_ICorDebugBreakpointEnum	ICorDebugBreakpointEnum	1.0
ver_ICorDebugStepperEnum	ICorDebugStepperEnum	1.0
ver_ICorDebugProcessEnum	ICorDebugProcessEnum	1.0
ver_ICorDebugThreadEnum	ICorDebugThreadEnum	1.0
ver_ICorDebugFrameEnum	ICorDebugFrameEnum	1.0
ver_ICorDebugChainEnum	ICorDebugChainEnum	1.0
ver_ICorDebugModuleEnum	ICorDebugModuleEnum	1.0
ver_ICorDebugValueEnum	ICorDebugValueEnum	1.0
ver_ICorDebugCodeEnum	ICorDebugCodeEnum	1.0
ver_ICorDebugTypeEnum	ICorDebugTypeEnum	1.0
ver_ICorDebugErrorInfoEnum	ICorDebugErrorInfoEnum	1.0
ver_ICorDebugAppDomainEnum	ICorDebugAppDomainEnum	1.0
ver_ICorDebugAssemblyEnum	ICorDebugAssemblyEnum	1.0
ver_ICorDebugEditAndContinueErrorInfo	ICorDebugEditAndContinueErrorInfo	1.0
ver_ICorDebugEditAndContinueSnapshot	ICorDebugEditAndContinueSnapshot	1.0
CorDebugVersion_1_1	The version of the .NET Framework, including all service packs, is 1.1.	1.1
CorDebugVersion_2_0	The version of the .NET Framework, including all service packs, is 2.0.	2.0
ver_ICorDebugManagedCallback2	ICorDebugManagedCallback2	2.0
ver_ICorDebugAppDomain2	ICorDebugAppDomain2	2.0
ver_ICorDebugProcess2	ICorDebugProcess2	2.0
ver_ICorDebugStepper2	ICorDebugStepper2	2.0
ver_ICorDebugRegisterSet2	ICorDebugRegisterSet2	2.0
ver_ICorDebugThread2	ICorDebugThread2	2.0
ver_ICorDebugILFrame2	ICorDebugILFrame2	2.0
ver_ICorDebugModule2	ICorDebugModule2	2.0
ver_ICorDebugFunction2	ICorDebugFunction2	2.0
ver_ICorDebugCode2	ICorDebugCode2	2.0
ver_ICorDebugClass2	ICorDebugClass2	2.0
ver_ICorDebugValue2	ICorDebugValue2	2.0
ver_ICorDebugEval2	The ICorDebugEval2.	2.0
ver_ICorDebugObjectValue2	ICorDebugObjectValue2	2.0
ver_ICorDebugThread3	ICorDebugThread3	4
ver_ICorDebugThread4	ICorDebugThread4	4
ver_ICorDebugStackWalk	ICorDebugStackWalk	4
ver_ICorDebugNativeFrame2	ICorDebugNativeFrame2	4
ver_ICorDebugInternalFrame2	ICorDebugInternalFrame2	4
ver_ICorDebugRuntimeUnwindableFrame	ICorDebugRuntimeUnwindableFrame	4
ver_ICorDebugHeapValue3	ICorDebugHeapValue3 Interface	4
ver_ICorDebugBlockingObjectEnum	ICorDebugBlockingObjectEnum Interface	4
CorDebugLatestVersion	The version of the .NET Framework, including all of its service packs, is the latest version.	-

Remarks

A debugger can use the CorDebugInterfaceVersion enumeration in the CreateDebuggingInterfaceFromVersion function to specify the highest version of the .NET Framework that the debugger supports.

Interface Names

The number that appears at the end of the interface names in the debugging API (for example, the "3" in ICorDebugThread3) specifies the version of the interface, not the version of the .NET Framework. All interface names in the debugging API include version numbers except for interfaces that were introduced in the .NET Framework version 1. Any correspondence between interface version numbers and.NET Framework version numbers are coincidental.

Interfaces that were introduced in the .NET Framework version 1.0 do not include numbers, because they are all implicitly version 1.
The .NET Framework version 1.1 uses version 1.0 interfaces, and does not introduce any new debugging interfaces.
The 14 debugging interfaces introduced in the .NET Framework version 2.0 are logical extensions of their version 1 counterparts and include the number "2" in their names.
The .NET Framework versions 3.0 and 3.5 use the existing .NET Framework 2.0 interfaces, and do not introduce any new interfaces.
The .NET Framework version 4 introduces a mix of interface versions. For example, both ICorDebugThread3 and ICorDebugThread4 appear as the third and fourth versions of the ICorDebugThread interface. The .NET Framework 4 also introduces the first version of the ICorDebugStackWalk interface and the second version of the ICorDebugNativeFrame interface (ICorDebugNativeFrame2).

Requirements

Platforms: See .NET Framework System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Share via

CorDebugInterfaceVersion Enumeration

Members

Remarks

Interface Names

Requirements

See Also

Other Resources

Additional resources