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

Article
02/26/2024

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 a la valeur NULL, l’alias nommé par l’utilisateur est supprimé.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Avant d’exécuter des commandes ou d’évaluer des expressions, le moteur de 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 si DstText a la valeur 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 à la méthode de rappel IDebugEventCallbacks ::ChangeEngineState .

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