IDebugBreakpoint2 ::GetOffsetExpression, méthode (dbgeng.h)

Article
02/06/2025

Les méthodes GetOffsetExpression retournent la chaîne d’expression qui prend la valeur de 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 tampon est NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] ExpressionSize

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

Valeur de retour

Retourner le code	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 suffisamment 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 Contrôle des indicateurs de point d’arrêt et des paramètres.)

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.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Partager via