Partager via


Méthode IDebugBreakpoint2 ::GetCommandWide (dbgeng.h)

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

Syntaxe

HRESULT GetCommandWide(
  [out, optional] PWSTR  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 Buffer 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 suffisamment grande pour contenir la chaîne de commande et la chaîne de commande a donc été tronquée pour tenir.
 

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 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)