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

Artículo
08/07/2023

El método SetTextReplacement establece el valor de un alias con nombre de usuario.

Sintaxis

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

Parámetros

[in] SrcText

Especifica el nombre del alias con nombre del usuario. El motor del depurador realiza una copia de esta cadena. Si SrcText es el mismo que el nombre de un alias automático, el nuevo alias con nombre de usuario oculta el alias automático.

[in, optional] DstText

Especifica el valor del alias con nombre del usuario. El motor del depurador realiza una copia de esta cadena. Si DstText es NULL, se quita el alias con nombre del usuario.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Antes de ejecutar comandos o evaluar expresiones, el motor del depurador reemplazará el alias especificado por SrcText por el valor del alias (especificado por DstText).

Si SrcText es un asterisco (*) y DstText es NULL, se quitan todos los alias con nombre de usuario. Este es el mismo comportamiento que el método RemoveTextReplacements .

Cuando este método cambia un alias, las devoluciones de llamada de eventos se notifican pasando la marca DEBUG_CES_TEXT_REPLACEMENTS al método de devolución de llamada IDebugEventCallbacks::ChangeEngineState .

Para obtener información general sobre los alias usados por el motor del depurador, consulte Uso de alias. Para obtener más información sobre el uso de alias con la API del motor de depurador, consulte Interacción con el motor.