通过

IDebugControl3：：GetTextReplacement 方法 （dbgeng.h）

  • 项目

GetTextReplacement 方法返回用户命名别名或自动别名的值。

语法

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

参数

[in, optional] SrcText

指定别名的名称。 引擎首先搜索具有此名称的用户命名别名。 然后，如果未找到匹配项，则搜索自动别名。 如果 SrcTextNULL，则 索引 用于指定别名。

[in] Index

指定别名的索引。 用户命名别名的索引在自动别名的索引之前。 仅当 SrcText 为 NULL NULL时，才使用 索引。 索引 可与 GetNumberTextReplacements 一起使用，以循环访问所有用户命名和自动别名。

[out, optional] SrcBuffer

接收别名的名称。 这是在 SrcText中指定的名称，如果 SrcText 未 NULL。 如果 SrcBufferNULL，则不会返回此信息。

[in] SrcBufferSize

指定 SrcBuffer 缓冲区的大小（以字符为单位）。

[out, optional] SrcSize

接收别名名称的大小（以字符为单位）。 如果 SrcSizeNULL，则不会返回此信息。

[out, optional] DstBuffer

接收由 SrcText 和 Index指定的别名的值。 如果 DstBufferNULL，则不会返回此信息。

[in] DstBufferSize

指定 DstBuffer 缓冲区的大小（以字符为单位）。

[out, optional] DstSize

接收别名值的大小（以字符为单位）。 如果 DstSizeNULL，则不会返回此信息。

返回值

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

返回代码 描述
S_OK
 该方法成功。

言论

在执行命令或计算表达式之前，调试器引擎会将 SrcBuffer 指定的别名替换为别名的值（由 DstBuffer指定）。

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

要求

要求 价值
目标平台 桌面
标头 dbgeng.h （包括 Dbgeng.h）

另请参阅

GetNumberTextReplacements

GetTextMacro

IDebugControl2

IDebugControl3

OutputTextReplacements

SetTextReplacement

al （列表别名）