IDebugControl3::SetTextReplacement 方法 (dbgeng.h)

SetTextReplacement 方法设置用户命名别名的值。

语法

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

参数

[in] SrcText

指定用户命名别名的名称。 调试器引擎创建此字符串的副本。 如果 SrcText 与自动别名的名称相同,则由新用户命名的别名隐藏自动别名。

[in, optional] DstText

指定用户命名别名的值。 调试器引擎创建此字符串的副本。 如果 DstTextNULL,则删除用户命名别名。

返回值

此方法也可能返回错误值。 有关更多详细信息,请参阅 返回值

返回代码 说明
S_OK
该方法成功。

注解

在执行命令或计算表达式之前,调试器引擎会将 SrcText 指定的别名替换为 由 DstText () 指定的别名的值。

如果 SrcText 是星号 () *DstTextNULL,则删除所有用户命名别名。 这与 RemoveTextReplacements 方法的行为相同。

此方法更改别名时,通过将DEBUG_CES_TEXT_REPLACEMENTS标志传递给 IDebugEventCallbacks::ChangeEngineState 回调方法,通知事件回调。

有关 调试器引擎使用的别名的概述,请参阅 使用别名。 有关将别名与调试器引擎 API 配合使用的详细信息,请参阅 与引擎交互

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h)

请参阅

GetTextReplacement

IDebugControl2

IDebugControl3

OutputTextReplacements

RemoveTextReplacements

SetTextMacro

ad(删除别名)

as、aS(设置别名)