Método IDebugControl4::SetTextReplacementWide (dbgeng.h)

Artigo
02/06/2025

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

Sintaxe

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

Parâmetros

[in] SrcText

Especifica o nome do alias nomeado pelo usuário. O mecanismo de 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 ficará oculto pelo novo alias nomeado pelo usuário.

[in, optional] DstText

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

Valor de retorno

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

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

Observações

Antes de executar comandos ou avaliar expressões, o mecanismo de 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 de 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.