Метод IDebugControl3::SetTextReplacement (dbgeng.h)
Метод SetTextReplacement задает значение псевдонима с именем пользователя.
Синтаксис
HRESULT SetTextReplacement(
[in] PCSTR SrcText,
[in, optional] PCSTR DstText
);
Параметры
[in] SrcText
Указывает имя псевдонима с именем пользователя. Подсистема отладчика создает копию этой строки. Если SrcText совпадает с именем автоматического псевдонима, автоматический псевдоним скрывается новым псевдонимом с именем пользователя.
[in, optional] DstText
Задает значение псевдонима с именем пользователя. Подсистема отладчика создает копию этой строки. Если DstText имеет значение NULL, псевдоним пользователя удаляется.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Перед выполнением команд или вычислением выражений подсистема отладчика заменит псевдоним, заданный SrcText , значением псевдонима (задается DstText).
Если SrcText является звездочкой (*), а DstText имеет значение NULL, все именованные пользователем псевдонимы удаляются. Это то же поведение, что и метод RemoveTextReplacements .
При изменении псевдонима этим методом обратные вызовы событий уведомляются путем передачи флага DEBUG_CES_TEXT_REPLACEMENTS методу обратного вызова IDebugEventCallbacks::ChangeEngineState .
Общие сведения о псевдонимах, используемых подсистемой отладчика, см. в разделе Использование псевдонимов. Дополнительные сведения об использовании псевдонимов с API обработчика отладчика см. в разделе Взаимодействие с обработчиком.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | dbgeng.h (включая Dbgeng.h) |