Méthode IDebugControl3 ::AddBreakpoint (dbgeng.h)

Article
02/23/2024

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

Syntaxe

HRESULT AddBreakpoint(
  [in]  ULONG             Type,
  [in]  ULONG             DesiredId,
  [out] PDEBUG_BREAKPOINT *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 choisit un ID inutilisé.

[out] Bp

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

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Le point d’arrêt n’a pas pu être créé avec l’ID souhaité ou la valeur 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. Pour plus d’informations sur la configuration et l’activation du point d’arrêt, consultez Utilisation de points d’arrêt.

Le client est enregistré en tant que adder du nouveau point d’arrêt. Consultez GetAdder.

Note 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é après l’appel de RemoveBreakpoint .