IDebugControl4：：SetTextReplacementWide 方法（dbgeng.h）

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

語法

HRESULT SetTextReplacementWide(
  [in]           PCWSTR SrcText,
  [in, optional] PCWSTR DstText
);

[in] SrcText

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

[in, optional] DstText

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

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

傳回碼	描述
S_OK	方法成功。

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

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

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

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

要求	價值
目標平臺	桌面
標頭	dbgeng.h （include Dbgeng.h）