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

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

Синтаксис

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

Параметры

[in] SrcText

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

[in, optional] DstText

Указывает значение псевдонима с именем пользователя. Обработчик отладчика создает копию этой строки. Если DstTextNULL, псевдоним с именем пользователя удаляется.

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

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

Замечания

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

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

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

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

Требования

См. также

GetTextReplacement

IDebugControl2

IDebugControl3

OutputTextReplacements

RemoveTextReplacements

SetTextMacro

ad (Delete Alias)

как aS (set Alias)