CorDebugInterfaceVersion 枚举

指定接口,.NET Framework 的版本,或在其中引入了接口的 .NET Framework 的版本。

语法

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,

    // CLR v4 - next major CLR version after CLR v2
    // Includes Silverlight 4
    CorDebugVersion_4_0 = CorDebugVersion_2_0 + 1,

    ver_ICorDebugThread3             = CorDebugVersion_4_0,
    ver_ICorDebugThread4             = CorDebugVersion_4_0,
    ver_ICorDebugStackWalk           = CorDebugVersion_4_0,
    ver_ICorDebugNativeFrame2        = CorDebugVersion_4_0,
    ver_ICorDebugInternalFrame2      = CorDebugVersion_4_0,
    ver_ICorDebugRuntimeUnwindableFrame = CorDebugVersion_4_0,
    ver_ICorDebugHeapValue3          = CorDebugVersion_4_0,
    ver_ICorDebugBlockingObjectEnum  = CorDebugVersion_4_0,
    ver_ICorDebugValue3 = CorDebugVersion_4_0,

    CorDebugVersion_4_5 = CorDebugVersion_4_0 + 1,

    ver_ICorDebugComObjectValue = CorDebugVersion_4_5,
    ver_ICorDebugAppDomain3 = CorDebugVersion_4_5,
    ver_ICorDebugCode3 = CorDebugVersion_4_5,
    ver_ICorDebugILFrame3 = CorDebugVersion_4_5,

    CorDebugLatestVersion = CorDebugVersion_4_5

} CorDebugInterfaceVersion;

成员

下表提供了从每个枚举值到相应的接口的链接。 此外,该表还指示了支持该接口的第一版 .NET Framework。

成员 指定 .NET Framework 版本
CorDebugInvalidVersion .NET Framework 的版本无效。 -
CorDebugVersion_1_0 .NET Framework(包括其所有 Service Pack)的版本为 1.0。 1.0
CorDebugVersion_1_1 .NET Framework(包括所有 Service Pack)的版本为 1.1。 1.1
CorDebugVersion_2_0 .NET Framework(包括所有 Service Pack)的版本为 2.0。 2.0
CorDebugVersion_4_0 .NET Framework(包括所有 Service Pack)的版本为 4。 4
CorDebugVersion_4_5 .NET Framework(包括所有 Service Pack)的版本为 4.5。 4.5
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
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 “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 接口 4
ver_ICorDebugBlockingObjectEnum ICorDebugBlockingObjectEnum 接口 4
ver_ICorDebugValue3 ICorDebugValue3 4
ver_ICorDebugComObjectValue ICorDebugComObjectValue 4.5
ver_ICorDebugAppDomain3 ICorDebugAppDomain3 4.5
ver_ICorDebugCode3 ICorDebugCode3 4.5
ver_ICorDebugILFrame3 ICorDebugILFrame3 4.5
CorDebugLatestVersion .NET Framework(包括其所有 Service Pack)的版本为最新版本。 -

备注

调试器可以将 CorDebugInterfaceVersion 枚举用于 CreateDebuggingInterfaceFromVersion 函数中,以指定调试器支持的 .NET Framework 的最高版本。

接口名称

出现在调试 API 中接口名称的末尾的数字(例如 ICorDebugThread3 中的“3”)指定接口版本,而不是 .NET Framework 的版本。 调试 API 中的所有接口名称包括除了 .NET Framework 版本 1 中引入的接口之外的版本号。 接口版本号和 .NET Framework 版本号之间的任何对应关系都是巧合。

  • 在 .NET Framework 版本 1.0 中引入的接口不包括数字,因为它们都是隐式版本 1。

  • .NET Framework 版本 1.1 使用版本 1.0 接口,并且并未引入任何新调试接口。

  • 在 .NET Framework 版本 2.0 中引入的 14 调试接口是版本 1 对应部分的逻辑扩展,并在其名称中包含数字“2”。

  • .NET Framework 版本 3.0 和 3.5 使用现有 .NET Framework 2.0 接口,并且并未引入任何新接口。

  • .NET Framework 4 引入了混合的接口版本。 例如,ICorDebugThread3ICorDebugThread4 显示为 ICorDebugThread 接口的第三个和第四个版本。 .NET Framework 4 也引入了 ICorDebugStackWalk 接口的第一个版本以及 ICorDebugNativeFrame 接口 (ICorDebugNativeFrame2) 的第二个版本。

要求

平台:请参阅系统要求

标头:CorDebug.idl、CorDebug.h

库:CorGuids.lib

.NET Framework 版本:自 2.0 起可用

请参阅