IDataModelScriptDebug2 ::GetCurrentPosition, méthode (dbgmodel.h)

La méthode GetCurrentPosition retourne la position actuelle dans le script. Cela ne peut être appelé que lorsque le script est décomposé dans le débogueur, où un appel à GetScriptState renvoie ScriptDebugBreak. Tout autre appel à cette méthode n’est pas valide et échoue.

La position du script est définie comme une étendue de caractères. Le début de l’étendue doit toujours être retourné (les numéros de ligne et de colonne). Si le débogueur particulier est capable de retourner l’étendue complète de la « position actuelle » dans le script, une position de fin peut éventuellement être retournée dans l’argument positionSpanEnd. Si le débogueur n’en est pas capable, les valeurs de ligne et de colonne à l’extrémité de l’étendue (le cas échéant) doivent être définies sur zéro.

Si le débogueur peut transmettre le code source de la ligne de code où le débogueur est défectueux, il peut le retourner à partir de cette méthode. Si possible, il est vivement recommandé de fournir ces informations. Toutefois, il n’est pas nécessaire de retourner plus d’informations que la ligne de départ et la colonne de la position d’arrêt. Si les informations de ligne source ne sont pas prises en charge, une valeur nullptr peut être retournée pour cet argument.

Syntaxe

HRESULT GetCurrentPosition(
  ScriptDebugPosition *currentPosition,
  ScriptDebugPosition *positionSpanEnd,
  BSTR                *lineText
);

Paramètres

currentPosition

La position d’arrêt actuelle du script doit être retournée ici. Les champs Ligne et Colonne de la structure retournée sont basés sur un. Une valeur zéro dans l’une ou l’autre indique que les informations ne sont pas disponibles.

positionSpanEnd

Si le débogueur est capable de déterminer l’étendue complète de la position d’arrêt, la position de fin de l’étendue peut être retournée ici. Si ce n’est pas le cas, aucune valeur doit être renseignée dans les champs Ligne et Colonne de la structure retournée.

lineText

Si le débogueur est capable de retourner le code source de la ligne (ou l’étendue) de l’arrêt, ce type peut être retourné ici sous forme de chaîne allouée par la fonction SysAllocString. L’appelant est responsable de la libération de la chaîne retournée avec SysFreeString. Si le débogueur n’est pas en mesure de produire ces informations sources, nullptr doit être retourné.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Configuration requise

Voir aussi

Interface IDataModelScriptDebug2