IDebugRegisters2::GetDescriptionWide 方法 (dbgeng.h)

GetDescriptionWide 方法返回寄存器的说明。

语法

HRESULT GetDescriptionWide(
  [in]            ULONG                       Register,
  [out, optional] PWSTR                       NameBuffer,
  [in]            ULONG                       NameBufferSize,
  [out, optional] PULONG                      NameSize,
  [out, optional] PDEBUG_REGISTER_DESCRIPTION Desc
);

参数

[in] Register

指定为其请求说明的寄存器的索引。

[out, optional] NameBuffer

指定要在其中存储寄存器名称的缓冲区。 如果 NameBufferNULL,则不会返回此信息。

[in] NameBufferSize

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

[out, optional] NameSize

NameBuffer 缓冲区中接收寄存器名称的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。 如果 NameSizeNULL,则不会返回此信息。

[out, optional] Desc

接收寄存器的说明。 有关详细信息 ,请参阅DEBUG_REGISTER_DESCRIPTION

返回值

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

返回代码 说明
S_OK
该方法成功。
S_FALSE
该方法成功。 但是,缓冲区不够大,无法保存寄存器的名称,因此它被截断。
E_UNEXPECTED
未指定目标计算机,或找不到寄存器的说明。
E_INVALIDARG
所请求的寄存器的索引大于目标计算机上的寄存器总数。

注解

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

要求

   
目标平台 桌面
Header dbgeng.h (包括 DbgEng.h)