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

Article
06/02/2025

La méthode GetTextMacro retourne la valeur d’un alias de nom fixe.

Syntaxe

C++

HRESULT GetTextMacro(
  [in]            ULONG  Slot,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG MacroSize
);

Paramètres

[in] Slot

Spécifie le nombre de l’alias de nom fixe. emplacement peut prendre les valeurs 0, 1, ..., 9, qui représentent les alias de nom fixe $u 0, $u 1, ..., $u 9.

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] MacroSize

Reçoit la taille, en caractères, de la valeur de l’alias.

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 emplacement par la valeur de l’alias (retourné à la mémoire tampon tampon).

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.