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

Article
02/06/2025

La méthode GetTextReplacement retourne la valeur d’un alias nommé par l’utilisateur ou d’un alias automatique.

Syntaxe

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

Paramètres

[in, optional] SrcText

Spécifie le nom de l’alias. Le moteur recherche d’abord les alias nommés par l’utilisateur pour un avec ce nom. Ensuite, si aucune correspondance n’est trouvée, les alias automatiques sont recherchés. Si SrcText est NULL, index est utilisé pour spécifier l’alias.

[in] Index

Spécifie l’index d’un alias. Les index des alias nommés par l’utilisateur se présentent avant les index des alias automatiques. d’index n’est utilisé que si SrcText est NULL. index pouvez être utilisé avec GetNumberTextReplacements pour itérer sur tous les alias nommés et automatiques par l’utilisateur.

[out, optional] SrcBuffer

Reçoit le nom de l’alias. Il s’agit du nom spécifié dans SrcText , si SrcText n’est pas NULL. Si SrcBuffer est NULL, ces informations ne sont pas retournées.

[in] SrcBufferSize

Spécifie la taille, en caractères, de la mémoire tampon SrcBuffer.

[out, optional] SrcSize

Reçoit la taille, en caractères, du nom de l’alias. Si SrcSize est NULL, ces informations ne sont pas retournées.

[out, optional] DstBuffer

Reçoit la valeur de l’alias spécifié par SrcText et Index. Si DstBuffer est NULL, ces informations ne sont pas retournées.

[in] DstBufferSize

Spécifie la taille, en caractères, de la mémoire tampon DstBuffer.

[out, optional] DstSize

Reçoit la taille, en caractères, de la valeur de l’alias. Si stSize est NULL, ces informations ne sont pas retournées.

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 de débogueur remplace l’alias spécifié par SrcBuffer par la valeur de l’alias (spécifiée par DstBuffer).

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.