WshShell.Run

The Run method creates a new process that executes strCommand with window style intWindowStyle.

Syntax

WshShell.Run (strCommand, [intWindowStyle], [blnWaitOnReturn])
 

Parameters

strCommand

Environment variables within the strCommand parameter are automatically expanded.

intWindowStyle

This is the value to which the wShowWindow element is set in the STARTUPINFO structure for the new process. Its significance is the same as the nCmdShow parameter of the ShowWindow function, and it may take one of the following values.

Name	Value	Meaning
SW_HIDE	0	Hides the window and activates another window.
SW_MINIMIZE	6	Minimizes the specified window and activates the next top-level window in the Z order.
SW_RESTORE	9	Activates and displays the window. If the window is minimized or maximized, Windows restores it to its original size and position. An application should specify this flag when restoring a minimized window.
SW_SHOW	5	Activates the window and displays it in its current size and position.
SW_SHOWMAXIMIZED	3	Activates the window and displays it as a maximized window.
SW_SHOWMINIMIZED	2	Activates the window and displays it as a minimized window.
SW_SHOWMINNOACTIVE	7	Displays the window as a minimized window. The active window remains active.
SW_SHOWNA	8	Displays the window in its current state. The active window remains active.
SW_SHOWNOACTIVATE	4	Displays a window in its most recent size and position. The active window remains active.
SW_SHOWNORMAL	1	Activates and displays a window. If the window is minimized or maximized, Windows restores it to its original size and position.

blnWaitOnReturn

If blnWaitOnReturn is not specified or FALSE, this method immediately returns to script execution rather than waiting for the process termination.

If blnWaitOnReturn is set to TRUE, the Run method returns any error code returned by the application. If blnWaitOnReturn is not specified or is FALSE, Run returns an error code of 0 (zero).

Example

' This fragment launches Notepad with the current executed script
  Set WshShell = Wscript.CreateObject("Wscript.Shell")
  WshShell.Run ("notepad " & Wscript.ScriptFullName)
  WshShell.Run ("%windir%\notepad" & Wscript.ScriptFullName)

' This fragment returns the error code from the executed application
  Return = WshShell.Run("notepad " & Wscript.ScriptFullName, 1, TRUE)

© 1997 by Microsoft Corporation. All rights reserved.