Process UDF, Get both the output & the exit code!

[TheDcoder]

 Hello Everyone , Are you tired of searching the forum for getting both the exit code & the stdout output? Then you are in the right place!

With this UDF you can get the both output & exit code of the command or the console app! Or you can get the exit code of another process without having to use RunWait...

Features:

1. Simple & Lightweight (15 KB)

2. Detailed comments & description

3. Flexible functions with many optional parameters

A BIG THANKS TO PsaltyDS for the functions! 2 of the (main) functions in the UDF are his work

 

List of functions:

Quote

_Process_RunCommand: Runs a command or a executable

_Process_WaitUntil: Waits until a process starts or quits. Also returns the exit code...

_Process_GetPID: Gets the PID of the process using the name of the process

_Process_GetPath: Get the path of a process along with its arguments (if any)

_Process_GetHandle: Gets the handle of a process, will be used later to retrive the exit code

_Process_CloseHandle: Closes the Process Handle of a process

_Process_GetExitCode: Gets the exit code of a process

_Process_DebugRunCommand: Debugs a command in CMD style, see the example.

Downloads:

Grab the latest (in development) code from GitHub

 

Hope it may help you, TD

 

P.S Icon made by Freepik from www.flaticon.com, Modified by TheDcoder

Edited July 22, 2017 by TheDcoder
Add link to GitHub

[mLipok]

Why you comment this $PROCESS_QUERY_INFORMATION ?

EDIT: Oh I see it in ProcessConstants.au3

EDIT:
use 

#AutoIt3Wrapper_Au3Check_Parameters=-q -d -w 1 -w 2 -w 3 -w- 4 -w 5 -w 6 -w- 7

EDIT:
the UDF FileName should be ProcessEx.au3 as Process.au3 exist in standard UDF.

 

EDIT:
Modified UDF:  Process UDF 0.9.zip

 

 

btw.
@TheDcoder publish this UDF in download section.

 

Edited August 14, 2015 by mLipok

[TheDcoder]

@mLipok What does this do?: 

#AutoIt3Wrapper_Au3Check_Parameters=-q -d -w 1 -w 2 -w 3 -w- 4 -w 5 -w 6 -w- 7

 I am still a newbie

[guinness]

Search Au3Check in the help file. It's what we use for the UDFs so we don't break peoples code.

[TheDcoder]

@guinness Thanks!

[TheDcoder]

Released new version , No big changes though

[mLipok]

Did you check my modification ?

[TheDcoder]

@mLipok , I didn't expect that you modified the code, I will include the changes in the next version

[TheDcoder]

Released new version , Change log:

Added _Process_DebugRunCommand (Modified version of DebugRunCommand in the example)

Updated functions, now all set @error to non-zero on failure

 

Some minor improvements, TD

[TheDcoder]

Released new version! , Change Log:

Added _Process_WaitUntil, Waits until a process starts or quits. Also returns the exit code...

Added _Process_GetPID, Gets the PID of the process using the name of the process

Updated _Process_DebugRunCommand, Now returns the output & exit code instead of True

Updated _Process_GetHandle, Now returns 0 instead of False on failure and now also accepts process names

 

Some minor improvements , You must download this update! Feature Packed!

[guinness]

Might want to fix these errors...

"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(110,79) : warning: $hProcessHandle possibly not declared/created yet
            $hProcessHandle = _Process_GetHandle($vProcess) ; Get the process handle :)
            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(110,79) : warning: $hProcessHandle: declared, but not used in func.
            $hProcessHandle = _Process_GetHandle($vProcess) ; Get the process handle :)
            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(136,68) : warning: $aProcess possibly not declared/created yet
    $aProcess = ProcessList($sProcess) ; List processes with that name
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(235,58) : warning: $sPartialOutput possibly not declared/created yet
        $sPartialOutput = StdoutRead($iPID) ; Record the output
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(246,52) : warning: $iExitCode possibly not declared/created yet
    $iExitCode = _Process_GetExitCode($hProcessHandle)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(253,22) : warning: $nMsg possibly not declared/created yet
        $nMsg = GUIGetMsg()
        ~~~~~~~~~~~~~~~~~~~^
"C:\Users\guinness\Downloads\Process_UDF_1.1\ProcessEx.au3"(138,25) : error: _ArrayDisplay(): undefined function.
    _ArrayDisplay($aProcess)
    ~~~~~~~~~~~~~~~~~~~~~~~^

 

[TheDcoder]

What the....!? What in the world is happening ? I fixed those errors before releasing to the public... It happen to me before too, I ended up deleting my original file with many modifications, I had to re-download my own UDF and make the changes again step by step... I should investigate ISN AutoIt Studio before I make any modifications

 

Thanks @guinness for pointing out, TD

[TheDcoder]

Updated current version: Removed AutoIt Check Derivative, was causing chaos... Turns out that the only glitched part was _ArrayDisplay... I didn't notice the Warnings because ISN does not show warnings

 

@guinness It will work now! TD

[guinness]

No, if this is a UDF and is to be included in other projects it should be passing Au3Check with those directive settings. We do it for the UDFs so code is clean and well written. Of course it's up to you whether or not you fix. Though be warned, it a user has a Global variable set as $aProcess (which is likely as user's tend not prefix global variables with $g_) then you have effectively broken their code, by overwriting with your data. Imagine if the UDFs did that? We would be getting complaints left right and centre.

[TheDcoder]

@guinness Hmmm... , I should change my mind before someone says the same thing and I fix it . Ok guinness, I will add it again in the next update

[TheDcoder]

Uploaded new version , Changelog:

 

Added _Process_GetPath function

Added $PROCESS_COMMAND, It contains the path of cmd with required parameters to run a command

Added Au3Check derivative (again... without chaos this time :P)

Changed _Process_DebugRunCommand, Now it shows more info about the process.

Removed $sPath parameter in _Process_RunCommand function, now use $PROCESS_COMMAND to run commands

 

Some small improvements , WARNING! THIS UPDATE CONTAINS MAJOR SCRIPT BREAKING CHANGES!, So update your script according to the changes

 

Enjoy! TD

[TheDcoder]

Updated , Changelog:

Added $PROCESS_DEBUG option

Changed Constant's values, they now are powers of 2 (for compatability with BitAND)

Changed _Process_RunCommand to accept $PROCESS_DEBUG, You can now debug directly using this function

Changed _Process_DebugRunCommand, Now you can resize it

 

Also some little cleanups

[JohnOne]

I hope you don't mind but I modified one of your functions.

Func _Process_GetPIDsuperEX($sProcess)
    Return ProcessExists($sProcess)
EndFunc

 

Edited October 23, 2015 by JohnOne

[TheDcoder]

@JohnOne Ohhhh... Thanks