.scriptrun (Exécuter le script)
La commande .scriptrun chargera et exécutera un script JavaScript.
.scriptrun ScriptFile
Paramètres
ScriptFile
Spécifie le nom du fichier de script à charger et à exécuter. ScriptFile doit inclure l’extension de nom de fichier .js. Des chemins absolus ou relatifs peuvent être utilisés. Les chemins relatifs sont relatifs au répertoire dans lequel vous avez démarré le débogueur. Les chemins de fichiers contenant des espaces ne sont pas pris en charge.
Environnement
| Élément | Description |
|---|---|
| Modes | Mode utilisateur, mode noyau |
| Targets | Live, vidage de la mémoire |
| Platforms | Tous |
Informations supplémentaires
La commande .scriptrun chargera un script et exécutera le code suivant.
- root
- intializeScript
- invokeScript
Un message de confirmation est affiché lorsque le code est chargé et exécuté.
0:000> .scriptrun C:\WinDbg\Scripts\helloWorld.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\helloWorld.js'
Hello World! We are in JavaScript!
Toutes les manipulations du modèle d’objet effectuées par le script resteront en place jusqu’à ce que le script soit ultérieurement déchargé ou soit exécuté à nouveau avec un contenu différent.
Ce tableau résume quelles fonctions sont exécutées par .scriptload et .scriptrun.
| .scriptload | .scriptrun | |
| root | Oui | Oui |
| initializeScript | Oui | Oui |
| invokeScript | Oui | |
| uninitializeScript |
Vous pouvez utiliser ce code pour voir quelles fonctions sont appelées avec la commande .scriptrun.
// Root of Script
host.diagnostics.debugLog("***>; Code at the very top (root) of the script is always run \n");
function initializeScript()
{
// Add code here that you want to run every time the script is loaded.
// We will just send a message to indicate that function was called.
host.diagnostics.debugLog("***>; initializeScript was called \n");
}
function invokeScript()
{
// Add code here that you want to run every time the script is executed.
// We will just send a message to indicate that function was called.
host.diagnostics.debugLog("***>; invokeScript was called \n");
}
Pour plus d’informations sur le travail avec JavaScript, veuillez consulter la section Script du débogueur JavaScript. Pour plus d’informations sur les objets de débogage, veuillez consulter la section Objets natifs dans les extensions JavaScript.
Spécifications
Avant d’utiliser l’une des commandes .script, un fournisseur de script doit être chargé. Utilisez la commande .load (Load Extension DLL) pour charger le fichier dll du fournisseur JavaScript.
0:000> .load C:\ScriptProviders\jsprovider.dll