Método IDebugControl2::SetTextReplacement (dbgeng.h)

Artigo
02/26/2024

O método SetTextReplacement define o valor de um alias nomeado pelo usuário.

Sintaxe

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

Parâmetros

[in] SrcText

Especifica o nome do alias nomeado pelo usuário. O mecanismo do depurador faz uma cópia dessa cadeia de caracteres. Se SrcText for o mesmo que o nome de um alias automático, o alias automático será oculto pelo novo alias nomeado pelo usuário.

[in, optional] DstText

Especifica o valor do alias nomeado pelo usuário. O mecanismo do depurador faz uma cópia dessa cadeia de caracteres. Se DstText for NULL, o alias nomeado pelo usuário será removido.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Antes de executar comandos ou avaliar expressões, o mecanismo do depurador substituirá o alias especificado por SrcText pelo valor do alias (especificado por DstText).

Se SrcText for um asterisco (*) e DstText for NULL, todos os aliases nomeados pelo usuário serão removidos. Esse é o mesmo comportamento que o método RemoveTextReplacements .

Quando um alias é alterado por esse método, os retornos de chamada de evento são notificados passando o sinalizador DEBUG_CES_TEXT_REPLACEMENTS para o método de retorno de chamada IDebugEventCallbacks::ChangeEngineState .

Para obter uma visão geral dos aliases usados pelo mecanismo do depurador, consulte Usando aliases. Para obter mais informações sobre como usar aliases com a API do mecanismo de depurador, consulte Interação com o mecanismo.