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

Artigo
02/23/2024

O método SetTextReplacementWide define o valor de um alias chamado 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 será oculto pelo novo alias chamado 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.

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 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.