IDebugControl2：：SetTextReplacement 方法 (dbgeng.h)

SetTextReplacement 方法會設定使用者命名別名的值。

語法

HRESULT SetTextReplacement(
  [in]           PCSTR SrcText,
  [in, optional] PCSTR DstText
);

[in] SrcText

指定使用者具名別名的名稱。調試程式引擎會建立此字串的複本。如果 SrcText 與自動別名的名稱相同，則新的使用者命名別名會隱藏自動別名。

[in, optional] DstText

指定使用者命名別名的值。調試程式引擎會建立此字串的複本。如果 DstText 為 NULL，則會移除使用者命名別名。

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

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

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

如果 SrcText 是星號 () * 且 DstText 為 NULL，則會移除所有使用者命名的別名。這是與 RemoveTextReplacements 方法相同的行為。

當此方法變更別名時，事件回呼會透過將DEBUG_CES_TEXT_REPLACEMENTS旗標傳遞至 IDebugEventCallbacks：：ChangeEngineState 回呼方法來通知。

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

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