IDebugRegisters2：：GetPseudoDescriptionWide 方法 (dbgeng.h)

GetPseudoDescriptionWide 方法返回伪寄存器的说明，包括其名称和类型。

语法

HRESULT GetPseudoDescriptionWide(
  [in]            ULONG    Register,
  [out, optional] PWSTR    NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 TypeModule,
  [out, optional] PULONG   TypeId
);

参数

[in] Register

指定请求其说明的伪寄存器的索引。 索引始终介于 0 和 getNumberPseudoRegisters (返回的伪寄存器数) 减 1 之间。

[out, optional] NameBuffer

接收伪寄存器的名称。 如果 NameBuffer 为 NULL，则不会返回此信息。

[in] NameBufferSize

指定 NameBuffer 指定的缓冲区的大小（以字符为单位）。 此大小包括“\0”终止字符的空间。

[out, optional] NameSize

接收伪寄存器名称的大小（以字符为单位）。 此大小包括“\0”终止字符的空间。 如果 NameSize 为 NULL，则不会返回此信息。

[out, optional] TypeModule

接收寄存器类型所属的模块的基址。 如果寄存器的类型未知，则返回零。 如果 TypeModule 为 NULL，则不返回任何信息。

[out, optional] TypeId

接收 TypeModule 中返回的模块中的类型的类型 ID。 如果类型 ID 未知，则返回零。 如果 TypeId 为 NULL，则不返回任何信息。

返回值

此列表不包含可能发生的所有错误。 有关可能错误的列表，请参阅 HRESULT 值。

返回代码	说明
S_OK	方法成功。
E_FAIL	寄存器的说明不可用

注解

说明并非始终适用于所有寄存器。 如果伪寄存器没有值（例如， $eventip 在事件发生之前没有值），或者无法确定伪寄存器的类型，则此方法将返回E_FAIL。

有关 IDebugRegisters 接口和其他寄存器相关方法的概述，请参阅 Registers。

要求

要求	值
目标平台	桌面
标头	dbgeng.h (包括 DbgEng.h)

另请参阅

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2