NSIS Wiki - User contributions [en]

NSIS-RunAs

2006-05-30T18:34:49Z

Wolfgang: /* Interface */

This is NSIS-RunAs, a dll to help NSIS installer scripts manage administrator
permissions on the processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers require administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.
Here is a visual example of such a login page:

http://nsis.sourceforge.net/mediawiki/images/c/c0/RunAs.jpg

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments: the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handle the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:34:05Z

Wolfgang: /* About NSIS-RunAs */

This is NSIS-RunAs, a dll to help NSIS installer scripts manage administrator
permissions on the processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers require administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.
Here is a visual example of such a login page:

http://nsis.sourceforge.net/mediawiki/images/c/c0/RunAs.jpg

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handle the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:33:12Z

Wolfgang:

This is NSIS-RunAs, a dll to help NSIS installer scripts manage administrator
permissions on the processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.
Here is a visual example of such a login page:

http://nsis.sourceforge.net/mediawiki/images/c/c0/RunAs.jpg

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handle the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:31:18Z

Wolfgang:

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.
Here is a visual example of such a login page:

http://nsis.sourceforge.net/mediawiki/images/c/c0/RunAs.jpg

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handle the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:29:38Z

Wolfgang:

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Screenshot==
Here is an example of a login page:

http://nsis.sourceforge.net/mediawiki/images/c/c0/RunAs.jpg

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handle the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

File:RunAs.jpg

2006-05-30T18:26:09Z

Wolfgang:

NSIS-RunAs

2006-05-30T18:17:36Z

Wolfgang: /* Interface */

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handle the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:16:49Z

Wolfgang: /* Interface */

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword, WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:13:45Z

Wolfgang: /* Interface */

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword,
WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
IntOp $0 $0 - 1
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:12:19Z

Wolfgang: /* Interface */

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword,
WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 1 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:08:13Z

Wolfgang:

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword,
WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 0 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

[[Category:User Accounts Related Functions]]

NSIS-RunAs

2006-05-30T18:03:56Z

Wolfgang: /* About NSIS-RunAs */

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for example, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword,
WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 0 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

NSIS-RunAs

2006-05-30T17:59:46Z

Wolfgang: /* Copyright */

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for examples, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword,
WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 0 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang_AT_NOSPAM_Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

NSIS-RunAs

2006-05-30T17:58:21Z

Wolfgang:

This is NSIS-RunAs, a dll to help NSIS installer scripts manager administrator
permissions on processes it launches.

==Download==
<attach>NSIS-RunAs.zip</attach>

==About NSIS-RunAs==
Sometimes, certain installers requires administator privileges to be able to
perform certain actions. For example to modify the registry or to install
files in protected areas of the filesystem. Those installers will either tell
you that you need to restart them as an administrator, or they will suggest
you to enter an appropriate username/password combination. This is what
NSIS-RunAs is meant to help you do.

The dll contains two functions: RunAsW and GetAdministrators. By creating
approriate dialogs with, for examples, the InstallOptions plugin, you could
create a login page that will lead the installer to be restarted.

==Interface==
The interface to those functions are the following:

<highlight-nsis>
WINAPI DWORD RunAsW (WCHAR *uusername, WCHAR *upassword,
WCHAR *ucommand, WCHAR **error);
WINAPI WCHAR **GetAdministrators (LPWSTR domain, LPDWORD read);
</highlight-nsis>

RunAsW takes 4 arguments, the username, the password, the command to execute
and a pointer to an error string. It returns 1 on success, 0 on failure.
The correct invocation with the System plugin would be

<highlight-nsis>
StrCpy $1 $username
StrCpy $2 $password
StrCpy $3 $command
StrCpy $4 0
System::Call 'RunAs::RunAsW(w r1, w r2, w r3, *w .r4) i .r0 ? u'
IntCmp $0 0 success
[failure code]
success:
[success code]
</highlight-nsis>

GetAdministrators is a bit more tricky to handle, since it will return an
array of wide-char pointers. Its arguments are the domain to query (leave it
to "" for the local machine) and a pointer to an integer that will receive the
number of user-accounts returned in the array.
The invocation of GetAdministrators would look like:

<highlight-nsis>
StrCpy $0 0
StrCpy $1 ""
StrCpy $2 0
StrCpy $3 0
System::Call 'RunAs::GetAdministrators(w r1, *i .r0) i .r2 ? u'
StrCpy $4 $2
loop:
IntCmp $0 0 endloop
System::Call '*$2(w .r3)'
[code to handles the username in $3]
System::Free $3 ; we free the memory used by the string
IntOp $2 $2 + 4 ; pointers have a size of 4 on 32 bit machines
Goto Loop
endloop:
System::Free $4 ; we free the memory used by the array
</highlight-nsis>

==Building==
I avoid using proprietary software, especially when free equivalents exists.
And I also encourage you to do so. Therefore I am using the GCC compiler
ported to Win32 by the mingw project. You can download the MingW SDK from
http://www.mingw.org/. Basically you need the GNU make utility, GCC and the
Win32 interface files.

In the case you want to use another compiling environment, I have named the
makefile "GNUmakefile" to avoid incompatibilities with other make utilities.
GNU make will recognize it as a regular makefile. Also, you might want to
replace the "__declspec(dllexport)" directive in the function declarations
with a similar directive or pragma for your environment. If you do so, please
send me your changes so that I can incorporate them in my tree.

==Copyright==
NSIS-RunAs is copyright (c) 2006 Wolfgang Sourdeau <Wolfgang@Contre.COM>

The NSIS-RunAs module is distributed under the GNU General Public License. You
can find a copy of this license in the file "COPYING.txt" in the Source
subdirectory of the distribution or at this address: http://www.gnu.org/licenses/gpl.html. An exception applies on the resulting RunAs.dll in the case you
use it along your product installer since it would only impair you and would
not be specially useful to your users either. This exception is documented in the header of the
file "NSIS-RunAs.c" in the Source subdirectory.

File:NSIS-RunAs.zip

2006-05-30T17:48:38Z

Wolfgang: A dll to interface with the System plugin to provide the user with an administrator login dialog.

A dll to interface with the System plugin to provide the user with an administrator login dialog.