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，則不會傳回此資訊。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。

傳回碼	描述
S_OK	此方法成功。

備註

在執行命令或評估表達式之前，調試程式引擎會將 SrcBuffer 指定的別名取代為 DstBuffer 所指定之別名的值 () 。

如需 調試程式引擎所使用的別名概觀，請參閱 使用別名。 如需搭配調試程式引擎 API 使用別名的詳細資訊，請參閱 與引擎互動。

規格需求

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)

另請參閱

GetNumberTextReplacements

GetTextMacro

IDebugControl2

IDebugControl3

OutputTextReplacements

SetTextReplacement

al (清單別名)