(dbgeng.h) IDebugRegisters2：：GetDescription 方法

  • 發行項

GetDescription 方法會傳回緩存器的描述。

語法

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

參數

[in] Register

指定要求描述的緩存器索引。

[out, optional] NameBuffer

指定要在其中儲存緩存器名稱的緩衝區。 如果 NameBuffer 為 NULL，則不會傳回此資訊。

[in] NameBufferSize

指定 NameBuffer 所指定緩衝區的大小，以字元為單位。 此大小包含 『\0』 終止字元的空間。

[out, optional] NameSize

在 NameBuffer 緩衝區中接收快取器名稱的大小，以字元為單位。 此大小包含 『\0』 終止字元的空間。 如果 NameSize 為 NULL，則不會傳回此資訊。

[out, optional] Desc

接收快取器的描述。 如需詳細資訊 ，請參閱DEBUG_REGISTER_DESCRIPTION 。

傳回值

此清單不包含可能發生的所有錯誤。 如需可能的錯誤清單，請參閱 HRESULT 值。

傳回碼 描述
S_OK
 此方法成功。
S_FALSE
 此方法成功。 不過，緩衝區不夠大，無法保存緩存器的名稱，因此已截斷。
E_UNEXPECTED
 未指定目標計算機，或找不到緩存器的描述。
E_INVALIDARG
 要求的緩存器索引大於目標電腦上的緩存器總數。

備註

如需 IDebugRegisters 介面和其他緩存器相關方法的概觀，請參閱 Registers。

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 DbgEng.h)