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 時，才會使用索引。 索引 可以與 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 使用別名的詳細資訊，請參閱 與引擎互動。

需求

另請參閱

GetNumberTextReplacements

GetTextMacro

IDebugControl2

IDebugControl3

OutputTextReplacements

SetTextReplacement

al （列出別名）