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

Article
02/23/2024

La méthode GetCommand retourne la chaîne de commande exécutée lorsqu’un point d’arrêt est déclenché.

Syntaxe

HRESULT GetCommand(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG CommandSize
);

Paramètres

[out, optional] Buffer

Chaîne de commande exécutée lorsque le point d’arrêt est déclenché. 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] CommandSize

Taille de la chaîne de commande. Si CommandSize 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 de commande et la chaîne de commande 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

La chaîne de commande est une liste de commandes de débogueur qui sont séparées par des points-virgules. Ces commandes sont exécutées chaque fois que le point d’arrêt est déclenché. Les commandes sont exécutées avant que le moteur informe les rappels d’événements que le point d’arrêt a été déclenché.

La méthode GetParameters retourne également la taille de la commande du point d’arrêt, CommandSize.

Pour plus d’informations sur les propriétés du point d’arrêt, consultez Contrôle des indicateurs et des paramètres de point d’arrêt.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Partager via