ShellExecAsUser plug-in - Revision history

GT5: The example was misleading, partly because "optional" was unclear. The plugin unconditionally does four popstring() calls on ShellExecAsUser invocation, which will mess up the stack state and put unexpected contents there if there are other items remaining on the stack.

2025-12-13T06:33:28Z

The example was misleading, partly because "optional" was unclear. The plugin unconditionally does four popstring() calls on ShellExecAsUser invocation, which will mess up the stack state and put unexpected contents there if there are other items remaining on the stack.

â† Older revision		Revision as of 06:33, 13 December 2025
Line 14:		Line 14:
	ShellExecAsUser::ShellExecAsUser action command [parameters] [SW_SHOWDEFAULT \| SW_SHOWNORMAL \| SW_SHOWMAXIMIZED \| SW_SHOWMINIMIZED \| SW_HIDE]		ShellExecAsUser::ShellExecAsUser action command [parameters] [SW_SHOWDEFAULT \| SW_SHOWNORMAL \| SW_SHOWMAXIMIZED \| SW_SHOWMINIMIZED \| SW_HIDE]
	</highlight-nsis>		</highlight-nsis>
	Note that action is usually "open", "print", etc, but can be an empty string to use the default action. Parameters and the show type are optional. $OUTDIR is used for the working directory.		Note that action is usually "open", "print", etc, but can be an empty string to use the default action. Parameters and the show type are optional, but must be provided as empty string ("") to get default behavior. $OUTDIR is used for the working directory.
	When installer process is non-elevated (e.g. executed on Windows XP, or UAC is disabled, etc), defaults to ShellExecute method.		When installer process is non-elevated (e.g. executed on Windows XP, or UAC is disabled, etc), defaults to ShellExecute method.

	Example:		Example:
	ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/'		<highlight-nsis>
			ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/' "" ""
			</highlight-nsis>

	== Limitations ==		== Limitations ==

Zanir: /* Download */

2019-10-23T15:32:43Z

Download

â† Older revision		Revision as of 15:32, 23 October 2019
Line 26:		Line 26:
	== Download ==		== Download ==
	Release (Ansi only) <attach>ShellExecAsUser.zip</attach> <br>		Release (Ansi only) <attach>ShellExecAsUser.zip</attach> <br>
	Unicode Update <attach>ShellExecAsUserUnicodeUpdate.zip</attach>		Unicode Update <attach>ShellExecAsUserUnicodeUpdate.zip</attach> <br>
			Amd64 Unicode <attach>ShellExecAsUser_amd64-Unicode.7z</attach>
	[[Category:Plugins]]		[[Category:Plugins]]

Installer32 at 19:39, 28 September 2018

2018-09-28T19:39:06Z

â† Older revision		Revision as of 19:39, 28 September 2018
Line 7:		Line 7:

	As such it's a light alternative to UAC plugin.		As such it's a light alternative to UAC plugin.
			[http://forums.winamp.com/showthread.php?t=335435 Forum thread]

	== Usage ==		== Usage ==
Line 24:		Line 25:

	== Download ==		== Download ==
	<attach>ShellExecAsUser.zip</attach>		Release (Ansi only) <attach>ShellExecAsUser.zip</attach> <br>
			Unicode Update <attach>ShellExecAsUserUnicodeUpdate.zip</attach>

	[[Category:Plugins]]		[[Category:Plugins]]

Bugmenot: /* Usage */

2015-03-17T00:12:15Z

Usage: <highlight-nsis>

â† Older revision		Revision as of 00:12, 17 March 2015
Line 10:		Line 10:
	== Usage ==		== Usage ==
	Syntax is exactly the same as NSIS built in ExecShell command:		Syntax is exactly the same as NSIS built in ExecShell command:
			<highlight-nsis>
	ShellExecAsUser::ShellExecAsUser action command [parameters] [SW_SHOWDEFAULT \| SW_SHOWNORMAL \| SW_SHOWMAXIMIZED \| SW_SHOWMINIMIZED \| SW_HIDE]		ShellExecAsUser::ShellExecAsUser action command [parameters] [SW_SHOWDEFAULT \| SW_SHOWNORMAL \| SW_SHOWMAXIMIZED \| SW_SHOWMINIMIZED \| SW_HIDE]
			</highlight-nsis>
	Note that action is usually "open", "print", etc, but can be an empty string to use the default action. Parameters and the show type are optional. $OUTDIR is used for the working directory.		Note that action is usually "open", "print", etc, but can be an empty string to use the default action. Parameters and the show type are optional. $OUTDIR is used for the working directory.
	When installer process is non-elevated (e.g. executed on Windows XP, or UAC is disabled, etc), defaults to ShellExecute method.		When installer process is non-elevated (e.g. executed on Windows XP, or UAC is disabled, etc), defaults to ShellExecute method.

	Example:		Example:
	ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/'		ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/'

	== Limitations ==		== Limitations ==

Bugmenot: /* Limitations */ typo

2014-07-29T19:22:42Z

Limitations: typo

â† Older revision		Revision as of 19:22, 29 July 2014
Line 20:		Line 20:

	== Limitations ==		== Limitations ==
	~~1) if~~ Explorer is not running or running as elevated process, plugin will launch elevated process.		#If Explorer is not running or running as elevated process, plugin will launch elevated process.
			#The process is launched under the same user Explorer is running. Under some circumstances (e.g. using runas to run installer on behalf of another user) desktop user may be different from before-elevation user.
	2) The process is launched under the same user Explorer is running. Under some circumstances (e.g. using runas to run installer on behalf of another user) desktop user may be different from before-elevation user.


	== Download ==		== Download ==

Installer32 at 21:16, 2 October 2011

2011-10-02T21:16:10Z

â† Older revision		Revision as of 21:16, 2 October 2011
Line 18:		Line 18:
	Example:		Example:
	ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/'		ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/'

			== Limitations ==
			1) if Explorer is not running or running as elevated process, plugin will launch elevated process.

			2) The process is launched under the same user Explorer is running. Under some circumstances (e.g. using runas to run installer on behalf of another user) desktop user may be different from before-elevation user.


	== Download ==		== Download ==

Installer32: ShellExecAsUser plug-in

2011-09-30T15:16:38Z

ShellExecAsUser plug-in

New page

== Description ==
Execute the specified program using ShellExecute in non-admin context.

The ShellExecAsUser plug-in is intended for installers that run with admin rights, but need to execute something as a normal non-elevated process.

This is accomplished by having Explorer launch the application on the installer’s behalf (http://brandonlive.com/2008/04/27/getting-the-shell-to-run-an-application-for-you-part-2-how/).

As such it's a light alternative to UAC plugin.

== Usage ==
Syntax is exactly the same as NSIS built in ExecShell command:

ShellExecAsUser::ShellExecAsUser action command [parameters] [SW_SHOWDEFAULT | SW_SHOWNORMAL | SW_SHOWMAXIMIZED | SW_SHOWMINIMIZED | SW_HIDE]

Note that action is usually "open", "print", etc, but can be an empty string to use the default action. Parameters and the show type are optional. $OUTDIR is used for the working directory.
When installer process is non-elevated (e.g. executed on Windows XP, or UAC is disabled, etc), defaults to ShellExecute method.

Example:
ShellExecAsUser::ShellExecAsUser "open" 'http://www.google.com/'

== Download ==
<attach>ShellExecAsUser.zip</attach>

[[Category:Plugins]]