ICorDebugRegisterSet::GetRegisters 方法

更新：2007 年 11 月

获取当前正在执行代码的计算机上由位掩码指定的每个寄存器的值。

HRESULT GetRegisters (
    [in] ULONG64       mask, 
    [in] ULONG32       regCount,
    [out, size_is(regCount), length_is(regCount)]
        CORDB_REGISTER regBuffer[]
);

参数

• mask
  [in] 指定要检索的寄存器值的位掩码。每个位与一个寄存器相对应。如果位设置为 1，则检索寄存器的值；否则，将不检索寄存器的值。

• regCount
  [in] 要检索的寄存器值的数目。

• regBuffer
  [out] 一个由 CORDB_REGISTER 对象构成的数组，其中的每个对象都会接收一个寄存器的值。

备注

数组的大小应和位掩码中设置为 1 的位的数目相等。regCount 参数指定将接收寄存器值的缓冲区中的元素数。如果 regCount 的值对于掩码指示的寄存器数而言太小，则将从集合中截断编号较高的寄存器。如果 regCount 的值太大，则未使用的 regBuffer 元素将保持不变。

如果位掩码指定的寄存器不可用，则 GetRegisters 将为该寄存器返回一个不确定值。

要求

**平台：**请参见 .NET Framework 系统要求。

**头文件：**CorDebug.idl

**库：**CorGuids.lib

**.NET Framework 版本：**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1、1.0

请参见

参考

ICorDebugRegisterSet

ICorDebugRegisterSet2