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
指定别名的名称。 引擎首先在用户命名的别名中搜索具有此名称的别名。 然后，如果未找到匹配项，则搜索自动别名。 如果 SrcText 为 NULL，则使用 Index 指定别名。
[in] Index
指定别名的索引。 用户命名别名的索引先于自动别名的索引。 仅当 SrcText 为 NULL 时，才使用索引。 索引 可以与 GetNumberTextReplacements 一起使用，以循环访问所有用户命名别名和自动别名。
[out, optional] SrcBuffer
接收别名的名称。 如果 SrcText 不为 NULL，则这是 SrcText 中指定的名称。 如果 SrcBuffer 为 NULL，则不会返回此信息。
[in] SrcBufferSize
指定 SrcBuffer 缓冲区的大小（以字符为单位）。
[out, optional] SrcSize
接收别名名称的大小（以字符为单位）。 如果 SrcSize 为 NULL，则不会返回此信息。
[out, optional] DstBuffer
接收 由 SrcText 和 Index 指定的别名的值。 如果 DstBuffer 为 NULL，则不会返回此信息。
[in] DstBufferSize
指定 DstBuffer 缓冲区的大小（以字符为单位）。
[out, optional] DstSize
接收别名值的大小（以字符为单位）。 如果 DstSize 为 NULL，则不会返回此信息。
返回值
此方法也可能返回错误值。 有关更多详细信息 ，请参阅返回值 。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
注解
在执行命令或计算表达式之前，调试器引擎会将 SrcBuffer 指定的别名替换为 DstBuffer) 指定的别名 (的值。
有关 调试器引擎使用的别名的概述，请参阅 使用别名。 有关将别名与调试器引擎 API 配合使用的详细信息，请参阅 与引擎交互。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h (包括 Dbgeng.h) |