Метод IDebugControl4::SetTextReplacementWide (dbgeng.h)

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

Синтаксис

HRESULT SetTextReplacementWide(
  [in]           PCWSTR SrcText,
  [in, optional] PCWSTR 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

IDebugControl4

OutputTextReplacements

RemoveTextReplacements

SetTextMacro

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

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