Partager via


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

Les méthodes GetOffsetExpression retournent la chaîne d’expression qui correspond à 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 correspond à l’emplacement sur la cible qui déclenche le point d’arrêt. Si La mémoire tampon 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 s’adapter.
 

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 Controling Breakpoint Flags and Parameters.)

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)