IDataModelScriptDebugStackFrame ::GetPosition, méthode (dbgmodel.h)
La méthode GetPosition retourne la position dans le script représenté par le cadre de pile. Cette méthode ne peut être appelée que lorsque le script se trouve dans un saut représenté par la pile dans laquelle ce frame est contenu. La position de la ligne et de la colonne dans ce cadre est toujours retournée. Si le débogueur est capable de retourner l’étendue de la « position d’exécution » dans le script, une position de fin peut ê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.
La ligne de texte (ou l’étendue de texte) représentant ce cadre peut éventuellement être renvoyée par les débogueurs qui le prennent en charge. Bien qu’il soit fortement recommandé que les débogueurs de script fassent toutes les tentatives pour retourner ce texte, il n’est pas nécessaire que ces débogueurs retournent plus que la position de ligne et de colonne du cadre. Si le texte de retour n’est pas pris en charge, un nullptr peut être retourné dans l’argument lineText.
Syntaxe
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Paramètres
position
Le débogueur doit renseigner les positions de ligne et de colonne du cadre dans cet argument.
positionSpanEnd
L’appelant peut éventuellement demander la fin de l’étendue de texte représentant ce cadre de pile en transmettant ici une valeur non nullptr. Si le débogueur peut prendre en charge une telle demande, il retourne ici les positions de ligne et de colonne ; sinon, les champs Ligne et Colonne de la structure de données doivent être définis sur zéro, ce qui indique que les valeurs ne peuvent pas être déterminées.
lineText
L’appelant peut éventuellement demander la ligne de code source (ou l’étendue) représentant la position du cadre. Si le débogueur est capable de renvoyer cela, il doit retourner ici une chaîne allouée par la fonction SysAllocString. L’appelant est responsable de la libération de la chaîne allouée avec SysFreeString. Si le débogueur n’est pas en mesure de renvoyer cela, nullptr doit être retourné ici.
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 |