Metodo IDebugControl4::SetTextReplacementWide (dbgeng.h)

Articolo
02/06/2025

Il metodo SetTextReplacementWide imposta il valore di un alias denominato dall'utente.

Sintassi

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

Parametri

[in] SrcText

Specifica il nome dell'alias denominato dall'utente. Il motore del debugger crea una copia di questa stringa. Se SrcText corrisponde al nome di un alias automatico, l'alias automatico viene nascosto dal nuovo alias denominato dall'utente.

[in, optional] DstText

Specifica il valore dell'alias denominato dall'utente. Il motore del debugger crea una copia di questa stringa. Se DstText è NULL, l'alias denominato dall'utente viene rimosso.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Prima di eseguire comandi o valutare espressioni, il motore del debugger sostituirà l'alias specificato da SrcText con il valore dell'alias (specificato da DstText).

Se SrcText è un asterisco (*) e DstText è null, vengono rimossi tutti gli alias denominati dall'utente. Si tratta dello stesso comportamento del metodo removeTextReplacements.

Quando un alias viene modificato da questo metodo, i callback dell'evento vengono informati passando il flag DEBUG_CES_TEXT_REPLACEMENTS al metodo di callback IDebugEventCallbacks::ChangeEngineState.

Per una panoramica degli alias usati dal motore del debugger , vedere Using Aliases. Per altre informazioni sull'uso di alias con l'API del motore di debugger, vedere Interazione con il motore.