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

Article
02/23/2024

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

Syntaxe

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

Paramètres

[in] Slot

Spécifie le numéro de l’alias de nom fixe. L’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 Slot. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] MacroSize

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

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 du débogueur remplace l’alias spécifié par Slot par la valeur de l’alias (retourné à la mémoire tampon ).

Pour obtenir une vue d’ensemble des alias utilisés par le moteur de 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.