Méthode IDebugBreakpoint2 ::GetOffsetExpression (dbgeng.h)

  • Article

Les méthodes GetOffsetExpression retournent la chaîne d’expression qui est évaluée à l’emplacement qui déclenche un point d’arrêt.

Syntaxe

HRESULT GetOffsetExpression(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExpressionSize
);

Paramètres

[out, optional] Buffer

Chaîne d’expression qui prend la valeur de l’emplacement sur la cible qui déclenche le point d’arrêt. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Taille, en caractères, de la mémoire tampon vers laquelle la mémoire tampon pointe.

[out, optional] ExpressionSize

Taille, en caractères, de la chaîne d’expression. Si ExpressionSize a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Code de retour Description
S_OK
 La méthode a réussi.
S_FALSE
 La méthode a réussi, mais la mémoire tampon n’était pas assez grande pour contenir la chaîne d’expression et la chaîne a donc été tronquée pour tenir.
 

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

Remarques

L’expression est évaluée chaque fois qu’un module est chargé ou déchargé. Si le débogueur ne peut pas évaluer l’expression (par exemple, si l’expression contient un symbole qui ne peut pas être interprété), le point d’arrêt est marqué comme différé. (Pour plus d’informations sur les points d’arrêt différés, consultez Contrôle des indicateurs et des paramètres de point d’arrêt.)

La méthode GetParameters retourne également la taille de la chaîne d’expression qui spécifie l’emplacement qui déclenche le point d’arrêt , ExpressionSize.

Pour plus d’informations sur l’utilisation des points d’arrêt, consultez Utilisation de points d’arrêt.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)