Metodo IDebugControl3::SetTextReplacement (dbgeng.h)

Articolo
02/23/2024

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

Sintassi

HRESULT SetTextReplacement(
  [in]           PCSTR SrcText,
  [in, optional] PCSTR 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 è stato eseguito correttamente.

Commenti

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, tutti gli alias denominati dall'utente vengono rimossi. Si tratta dello stesso comportamento del metodo RemoveTextReplacements .

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

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