IDebugControl2 ::SetTextReplacement, méthode (dbgeng.h)

Article
02/06/2025

La méthode SetTextReplacement définit la valeur d’un alias nommé par l’utilisateur.

Syntaxe

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

Paramètres

[in] SrcText

Spécifie le nom de l’alias nommé par l’utilisateur. Le moteur de débogueur effectue une copie de cette chaîne. Si SrcText est identique au nom d’un alias automatique, l’alias automatique est masqué par le nouvel alias nommé par l’utilisateur.

[in, optional] DstText

Spécifie la valeur de l’alias nommé par l’utilisateur. Le moteur de débogueur effectue une copie de cette chaîne. Si DstText est NULL, l’alias nommé par l’utilisateur est supprimé.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Avant d’exécuter des commandes ou d’évaluer des expressions, le moteur du débogueur remplace l’alias spécifié par SrcText par la valeur de l’alias (spécifiée par DstText).

Si SrcText est un astérisque (*) et DstText est NULL, tous les alias nommés par l’utilisateur sont supprimés. Il s’agit du même comportement que la méthode RemoveTextReplacements.

Lorsqu’un alias est modifié par cette méthode, les rappels d’événements sont avertis en passant l’indicateur DEBUG_CES_TEXT_REPLACEMENTS à l'IDebugEventCallbacks ::ChangeEngineState méthode de rappel.

Pour obtenir une vue d’ensemble des alias utilisés par le moteur de débogueur , consultez Using Aliases. Pour plus d’informations sur l’utilisation d’alias avec l’API du moteur de débogueur, consultez Interaction avec le moteur.