IDebugControl4 ::AddBreakpoint2, méthode (dbgeng.h)

Article
02/06/2025

La méthode AddBreakpoint2 crée un point d’arrêt pour la cible actuelle.

Syntaxe

HRESULT AddBreakpoint2(
  [in]  ULONG              Type,
  [in]  ULONG              DesiredId,
  [out] PDEBUG_BREAKPOINT2 *Bp
);

Paramètres

[in] Type

Spécifie le type de point d’arrêt du nouveau point d’arrêt. Il peut s’agir de l’une des valeurs suivantes :

Valeur	Description
DEBUG_BREAKPOINT_CODE	point d’arrêt logiciel
DEBUG_BREAKPOINT_DATA	point d’arrêt du processeur

[in] DesiredId

Spécifie l’ID souhaité du nouveau point d’arrêt. S’il est DEBUG_ANY_ID, le moteur sélectionne un ID inutilisé.

[out] Bp

Reçoit un pointeur d’interface vers le nouveau point d’arrêt.

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Impossible de créer le point d’arrêt avec l’ID souhaité ou la valeur de Type n’a pas été reconnue.

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

Remarques

Si DesiredId n’est pas DEBUG_ANY_ID et qu’un autre point d’arrêt utilise déjà l’ID DesiredId, ces méthodes échouent.

Les points d’arrêt sont créés vides et désactivés. Consultez Utilisation de points d’arrêt pour plus d’informations sur la configuration et l’activation du point d’arrêt.

Le client est enregistré en tant que module complémentaire du nouveau point d’arrêt. Voir GetAdder.

Remarque Même si IDebugBreakpoint étend l’interface COM IUnknown , la durée de vie du point d’arrêt n’est pas contrôlée à l’aide de l’interface IUnknown. Au lieu de cela, le point d’arrêt est supprimé une fois RemoveBreakpoint est appelé.

Exigences

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

Voir aussi

points d’arrêt

IDebugBreakpoint

IDebugControl4

RemoveBreakpoint

utilisation de points d’arrêt

Partager via