Aide:RunAsWait.txt

Document original V3.3.6.1 :

###Function###
RunAsWait

###Description###
Runs an external program under the context of a different user and pauses script execution until the program finishes.

###Syntax###
RunAsWait ( "username", "domain", "password", logon_flag, "program" [, "workingdir" [, show_flag [, opt_flag ]]] )


###Parameters###
@@ParamTable@@
username
	The username to log on with.
domain
	The domain to authenticate against.
password
	The password for the user.
logon_flag
	0 - Interactive logon with no profile.
	1 - Interactive logon with profile.
	2 - Network credentials only.
	4 - Inherit the calling processes environment instead of the user's.
program
	The full path of the program (EXE, BAT, COM, or PIF) to run (see remarks).
workingdir
	[optional] The working directory.  If not specified, then the value of @SystemDir will be used.  This is not the path to the program.
show_flag
	[optional] The "show" flag of the executed program:
	  @SW_HIDE = Hidden window (or Default keyword)
	  @SW_MINIMIZE = Minimized window
	  @SW_MAXIMIZE = Maximized window
opt_flag
	[optional] Controls various options related to how the parent and child process interact.
	  0x10000 ($RUN_CREATE_NEW_CONSOLE) = The child console process should be created with it's own window instead of using the parent's window.  This flag is only useful when the parent is compiled as a Console application.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns the exit code of the program that was run.
Failure:	Returns 0 and sets @error to non-zero.
@@End@@


###Remarks###
Paths with spaces need to be enclosed in quotation marks.

It is important to specify a working directory the user you are running as has access to, otherwise the function will fail.

It is recommended that you only load the user's profile is you are sure you need it.  There is a small chance a profile can be stuck in memory under the right conditions.  If a script using RunAs() happens to be running as the SYSTEM account (for example, if the script is running as a service) and the user's profile is loaded, then you must take care that the script remains running until the child process closes.

When running as an administrator, the Secondary Logon (RunAs) service must be enabled or this function will fail.  This does not apply when running as the SYSTEM account.

After running the requested program the script pauses until the program terminates.  To run a program and then immediately continue script execution use the RunAs function instead.

Some programs will appear to return immediately even though they are still running; these programs spawn another process - you may be able to use the ProcessWaitClose function to handle these cases.

The "load profile" and "network credentials only" options are incompatible.  Using both will produce undefined results.

There is an issue in the Windows XP generation of Windows which prevents STDIO redirection and the show flag from working.  See Microsoft Knowledge Base article KB818858 for more information about which versions are affected as well as a hotfix for the issue.  User's running Windows 2000, Windows XP SP2 or later, or Windows Vista are not affected.

###Related###
ProcessWait, ProcessWaitClose, Run, RunWait, ShellExecute, ShellExecuteWait, RunAs


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

Texte en Français

Traducteur :

Contributeurs (pour les modifications avant le Wiki) :