Metodo IDebugControl2::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, viene rimosso l'alias denominato dall'utente.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, 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, 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 degli eventi vengono notificati passando il flag DEBUG_CES_TEXT_REPLACEMENTS al metodo IDebugEventCallbacks::ChangeEngineState callback.

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