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

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

[out, optional] SrcBuffer

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

[in] SrcBufferSize

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

[out, optional] SrcSize

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

[out, optional] DstBuffer

接收 SrcTextIndex 指定的别名的值。 如果 DstBufferNULL,则不会返回此信息。

[in] DstBufferSize

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

[out, optional] DstSize

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

返回值

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

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

注解

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

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

要求

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

另请参阅

GetNumberTextReplacements

GetTextMacro

IDebugControl2

IDebugControl3

OutputTextReplacements

SetTextReplacement

al(列出别名)