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

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

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