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

  • Статья

Метод SetTextReplacement задает значение псевдонима с именем пользователя.

Синтаксис

HRESULT SetTextReplacement(
  [in]           PCSTR SrcText,
  [in, optional] PCSTR DstText
);

Параметры

[in] SrcText

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

[in, optional] DstText

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

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

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

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

Комментарии

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

Если SrcText является звездочкой (*), а DstText имеет значение NULL, все именованные пользователем псевдонимы удаляются. Это то же поведение, что и метод RemoveTextReplacements .

При изменении псевдонима этим методом обратные вызовы событий уведомляются путем передачи флага DEBUG_CES_TEXT_REPLACEMENTS методу обратного вызова IDebugEventCallbacks::ChangeEngineState .

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

GetTextReplacement

IDebugControl2

IDebugControl3

OutputTextReplacements

RemoveTextReplacements

SetTextMacro

ad (удаление псевдонима)

as, aS (задать псевдоним)