IDataModelScriptDebugStackFrame ::GetPosition, méthode (dbgmodel.h)
La méthode GetPosition retourne la position dans le script représenté par le frame de pile. Cette méthode peut uniquement être appelée lorsque le script se trouve dans un saut représenté par la pile dans laquelle cette trame est contenue. La position de ligne et de 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’est pas capable de cela, les valeurs de ligne et de colonne de l’étendue (si demandé) 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 des débogueurs qui le prennent en charge. Bien qu’il soit fortement recommandé que les débogueurs de script effectuent chaque tentative de 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 remplir 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 les positions de ligne et de colonne ici ; 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 frame. Si le débogueur est capable de le retourner, il doit retourner ici une chaîne allouée par la fonction SysAllocString. L’appelant est chargé de libérer la chaîne allouée avec SysFreeString. Si le débogueur n’est pas en mesure de retourner cela, nullptr doit être retourné ici.
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 |