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

Статья
08/07/2023

Метод 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

Указывает имя псевдонима. Подсистема сначала выполняет поиск псевдонимов с именем пользователя для псевдонимов с этим именем. Затем, если совпадение не найдено, выполняется поиск по автоматическим псевдонимам. Если SrcText имеет значение NULL, индекс используется для указания псевдонима.

[in] Index

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

[out, optional] SrcBuffer

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

[in] SrcBufferSize

Указывает размер буфера SrcBuffer (в символах).

[out, optional] SrcSize

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

[out, optional] DstBuffer

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

[in] DstBufferSize

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

[out, optional] DstSize

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

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