Méthode IDataModelScriptDebug ::GetCurrentPosition (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’est pas capable de cela, les valeurs de ligne et de colonne à la fin de l’étendue (si demandé) 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 endommagé, il peut retourner ce code à partir de cette méthode. Si possible, il est vivement encouragé à 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 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, les valeurs zéro doivent être renseignées dans les champs Ligne et Colonne de la structure retournée.
lineText
Si le débogueur est capable de retourner le code source pour la ligne (ou l’étendue) de l’arrêt, ce type peut être retourné ici sous la forme d’une chaîne allouée par la fonction SysAllocString. L’appelant est chargé de libérer la chaîne retournée avec SysFreeString. Si le débogueur ne peut pas 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
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |