Метод IDebugControl3::GetTextReplacement (dbgeng.h)

Статья
02/06/2025

Метод GetTextReplacement возвращает значение именованного пользователем псевдонима или автоматического псевдонима.

Синтаксис

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

Параметры

[in, optional] SrcText

Задает имя псевдонима. Подсистема сначала выполняет поиск псевдонимов с именем пользователя для одного с таким именем. Затем, если совпадение не найдено, выполняется поиск автоматических псевдонимов. Если SrcTextNULL, используется индекс для указания псевдонима.

[in] Index

Указывает индекс псевдонима. Индексы именованных пользователем псевдонимов приходят до индексов автоматических псевдонимов. индекс используется только в том случае, если SrcTextNULL. индекс можно использовать вместе с GetNumberTextReplacements для итерации всех именованных пользователем и автоматических псевдонимов.

[out, optional] SrcBuffer

Получает имя псевдонима. Это имя, указанное в SrcText, если SrcText не NULL. Если SrcBufferNULL, эти сведения не возвращаются.

[in] SrcBufferSize

Задает размер в символах буфера SrcBuffer.

[out, optional] SrcSize

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

[out, optional] DstBuffer

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

[in] DstBufferSize

Задает размер в символах буфера DstBuffer.

[out, optional] DstSize

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

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

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

Замечания

Перед выполнением команд или вычислением выражений подсистема отладчика заменит псевдоним, указанный SrcBuffer значением псевдонима (задается DstBuffer).

Общие сведения об псевдонимах, используемых подсистемой отладчика , см. в разделе Using Aliases. Дополнительные сведения об использовании псевдонимов с API обработчика отладчика см. в взаимодействии с подсистемой.