home *** CD-ROM | disk | FTP | other *** search
/ Hackers Magazine 57 / CdHackersMagazineNr57.iso / Software / Programming / nsis-2.46-setup.exe / Docs / nsExec / nsExec.txt
Encoding:
Text File  |  2007-12-01  |  1.4 KB  |  49 lines
  1. nsExec
  2. ------
  3. nsExec will execute command-line based programs and capture the output
  4. without opening a dos box.
  5.  
  6.  
  7. Usage
  8. -----
  9. nsExec::Exec [/OEM] [/TIMEOUT=x] path
  10.  
  11. -or-
  12.  
  13. nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path
  14.  
  15. -or-
  16.  
  17. nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path
  18.  
  19. All functions are the same except ExecToLog will print the output
  20. to the log window and ExecToStack will push up to ${NSIS_MAX_STRLEN}
  21. characters of output onto the stack after the return value.
  22.  
  23. Use the /OEM switch to convert the output text from OEM to ANSI.
  24.  
  25. The timeout value is optional.  The timeout is the time in
  26. milliseconds nsExec will wait for output.  If output from the
  27. process is received, the timeout value is reset and it will
  28. again wait for more output using the timeout value.  See Return 
  29. Value for how to check if there was a timeout.
  30.  
  31. To ensure that command are executed without problems on all windows versions,
  32. is recommended to use the following syntax:
  33.  
  34.    nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'
  35.  
  36. This way the application path may contain non 8.3 paths (with spaces)
  37.  
  38. Return Value
  39. ------------
  40. If nsExec is unable to execute the process, it will return "error"
  41. on the top of the stack, if the process timed out it will return
  42. "timeout", else it will return the return code from the
  43. executed process.
  44.  
  45.  
  46. Copyright Info
  47. --------------
  48. Copyright (c) 2002 Robert Rainwater
  49. Thanks to Justin Frankel and Amir Szekely