21f668de9c
git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@2762 212acab6-be3b-0410-9dea-997c60f758d6
53 lines
No EOL
1.6 KiB
Text
53 lines
No EOL
1.6 KiB
Text
nsExec
|
|
------
|
|
nsExec will execute command-line based programs and capture the output
|
|
without opening a dos box.
|
|
|
|
|
|
Usage
|
|
-----
|
|
nsExec::Exec [/TIMEOUT=x] [/CMD] path
|
|
|
|
-or-
|
|
|
|
nsExec::ExecToLog [/TIMEOUT=x] [/CMD] path
|
|
|
|
-or-
|
|
|
|
nsExec::ExecToStack [/TIMEOUT=x] [/CMD] path
|
|
|
|
All functions are the same except ExecToLog will print the output
|
|
to the logwindow and ExecToStack will push up to ${NSIS_MAX_STRLEN}
|
|
characters of output onto the stack after the return value.
|
|
|
|
The timeout value is optional. The timeout is the time in
|
|
milliseconds nsExec will wait for output. If output from the
|
|
process is received, the timeout value is reset and it will
|
|
again wait for more output using the timeout value. See Return
|
|
Value for how to check if there was a timeout.
|
|
|
|
The /CMD param is optional. The /CMD indicates that the exec procedure should use
|
|
command processor to execute the command, ie, %COMSPEC% path
|
|
|
|
*IMPORTANT NOTICE* The /CMD param should be used for 16bits MS-DOS applications
|
|
or applications that create windows, or any form of user interface
|
|
|
|
To ensure that command are executed without problems on all windows versions,
|
|
is recommended to use the following syntax:
|
|
|
|
nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'
|
|
|
|
This way the application path may contain non 8.3 paths (with spaces)
|
|
|
|
Return Value
|
|
------------
|
|
If nsExec is unable to execute the process, it will return "error"
|
|
on the top of the stack, if the process timed out it will return
|
|
"timeout", else it will return the return code from the
|
|
executed process.
|
|
|
|
|
|
Copyright Info
|
|
--------------
|
|
Copyright (c) 2002 Robert Rainwater
|
|
Thanks to Justin Frankel and Amir Szekely |