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)