IDebugControl2：：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 時，才會使用 Index。 索引 可以與 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) |