IDebugControl3：：SetTextReplacement 方法 （dbgeng.h）
SetTextReplacement 方法设置用户命名别名的值。
语法
HRESULT SetTextReplacement(
[in] PCSTR SrcText,
[in, optional] PCSTR DstText
);
参数
[in] SrcText
指定用户命名别名的名称。 调试器引擎 创建此字符串的副本。 如果 SrcText 与自动别名的名称相同，则新用户命名别名会隐藏自动别名。
[in, optional] DstText
指定用户命名别名的值。 调试器引擎创建此字符串的副本。 如果 DstTextNULL，则删除用户命名的别名。
返回值
此方法也可能返回错误值。 有关详细信息，请参阅 返回值。
| 返回代码 | 描述 |
|---|---|
|
该方法成功。 |
言论
在执行命令或计算表达式之前，调试器引擎会将 SrcText 指定的别名替换为别名的值（由 DstText指定）。
如果 SrcText 是星号（*），并且 DstText为 NULL，则删除所有用户命名别名。 这与 RemoveTextReplacements 方法的行为相同。
此方法更改别名时，将DEBUG_CES_TEXT_REPLACEMENTS标志传递给 IDebugEventCallbacks：：ChangeEngineState 回调方法，从而通知事件回调。
有关 调试器引擎使用的别名的概述，请参阅 使用别名。 有关将别名与调试器引擎 API 配合使用的详细信息，请参阅 与引擎交互。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h （包括 Dbgeng.h） |