.scriptrun (Skript ausführen)
Mit dem Befehl .scriptrun wird ein JavaScript geladen und ausgeführt.
.scriptrun ScriptFile
Parameter
ScriptFile
Gibt den Namen der Skriptdatei an, die geladen und ausgeführt werden soll. ScriptFile sollte die Dateinamenerweiterung .js enthalten. Es können absolute oder relative Pfade verwendet werden. Relative Pfade sind relativ zu dem Verzeichnis, in dem Sie den Debugger gestartet haben. Dateipfade, die Leerzeichen enthalten, werden nicht unterstützt.
Environment
| Element | Beschreibung |
|---|---|
| Modi | Benutzermodus, Kernel-Modus |
| Ziele | Live, Crash Dump |
| Plattformen | Alle |
Zusätzliche Informationen
Mit dem Befehl .scriptrun wird ein Skript geladen und der folgende Code ausgeführt.
- root
- intializeScript
- invokeScript
Eine Bestätigungsmeldung wird angezeigt, wenn der Code geladen und ausgeführt wird.
0:000> .scriptrun C:\WinDbg\Scripts\helloWorld.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\helloWorld.js'
Hello World! We are in JavaScript!
Alle durch das Skript vorgenommenen Objektmodellmanipulationen bleiben erhalten, bis das Skript später entladen oder mit anderem Inhalt erneut ausgeführt wird.
In dieser Tabelle ist zusammengefasst, welche Funktionen von .scriptload und .scriptrun ausgeführt werden.
| .scriptload | .scriptrun | |
| root | ja | ja |
| initializeScript | ja | ja |
| invokeScript | ja | |
| uninitializeScript |
Sie können diesen Code verwenden, um zu sehen, welche Funktionen mit dem Befehl .scriptrun aufgerufen werden.
// 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");
}
Weitere Informationen zur Arbeit mit JavaScript finden Sie unter Debuggerskripts mit JavaScript. Weitere Informationen zu den Debugger-Objekten finden Sie unter Native Objects in JavaScript Extensions.
Anforderungen
Bevor Sie einen der .script-Befehle verwenden können, muss ein Scripting Provider geladen werden. Verwenden Sie den Befehl .load (Load Extension DLL), um die JavaScript-Provider-DLL zu laden.
0:000> .load C:\ScriptProviders\jsprovider.dll