IDataModelScriptDebug ::GetCurrentPosition, méthode (dbgmodel.h)
La méthode GetCurrentPosition retourne la position actuelle dans le script. Cela peut uniquement être appelé lorsque le script est divisé en débogueur où un appel à GetScriptState retourne 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 de l’étendue (si demandé) doivent être définies sur zéro.
Si le débogueur peut passer le code source de la ligne de code où le débogueur est rompu, il peut retourner de cette méthode. Si possible, il est fortement encouragé à fournir ces informations. Toutefois, il n’est pas nécessaire de renvoyer 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 nulle dans l’un 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 de l’étendue) de l’arrêt, il peut être retourné ici sous forme de 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 n’est pas en mesure de produire ces informations sources, nullptr doit être retourné.
Valeur de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |