Метод IDebugRegisters2::GetPseudoDescription (dbgeng.h)

Статья
02/06/2025

Метод GetPseudoDescription возвращает описание псевдорегистрирования, включая его имя и тип.

Синтаксис

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

Параметры

[in] Register

Задает индекс псевдорегистрации, описание которого запрашивается. Индекс всегда находится между нулем и числом псевдорегистрированных регистров (возвращено GetNumberPseudoRegisters) минус один.

[out, optional] NameBuffer

Получает имя псевдорегистрирующего регистра. Если NameBufferNULL, эти сведения не возвращаются.

[in] NameBufferSize

Задает размер в символах буфера, который NameBuffer . Этот размер включает пробел для завершающего символа \0.

[out, optional] NameSize

Получает размер в символах имени псевдорегистрирующего регистра. Этот размер включает пробел для завершающего символа \0. Если NameSizeNULL, эти сведения не возвращаются.

[out, optional] TypeModule

Получает базовый адрес модуля, которому принадлежит тип регистра. Если тип регистра не известен, возвращается ноль. Если TypeModuleNULL, данные не возвращаются.

[out, optional] TypeId

Получает идентификатор типа типа в модуле, возвращенном в TypeModule. Если идентификатор типа не известен, возвращается ноль. Если TypeIdЗНАЧЕНИЕ NULL, данные не возвращаются.

Возвращаемое значение

Этот список не содержит всех ошибок, которые могут возникнуть. Список возможных ошибок см. в значений HRESULT.

Возвращаемый код	Описание
S_OK	Метод был успешным.
E_FAIL	Описание регистрации недоступно

Замечания

Описания не всегда доступны для всех регистров. Если псевдорегистрированный регистр не имеет значения , например, $eventip не будет иметь значение перед событием - или тип не может быть определен для псевдорегистрированного регистра, этот метод вернет E_FAIL.

Общие сведения о интерфейсе IDebugRegisters и других методах, связанных с регистрами, см. в разделе Registers.