Sys2QueryProcess: Difference between revisions

Latest revision as of 00:50, 4 July 2023

Queries information about the specified process.

Specifying a process ID of 0 will return the information for the current process (that is, the process calling this function); note that this requires the second parameter to specify that the identifier is in fact a process ID ('P' or 'H') rather than an executable name.

Arguments

The process identifier (program name or process ID) (REQUIRED)
Flag indicating the identifier type:
'P': decimal process ID

'H': hexadecimal process ID

'N': executable program name (with or without extension) (DEFAULT)

Return Value

A string of the format:

pid parent-pid process-type priority cpu-time executable-name

"priority" is in hexadecimal notation, all other numbers are decimal.

"" is returned if the process was not found or if an internal error occurred.

@@ Line 4: / Line 4: @@
 ==Arguments==
-REXX ARGUMENTS:
+# The process identifier (program name or process ID) (REQUIRED)
-. The process identifier (program name or process ID) (REQUIRED)
+# Flag indicating the identifier type:
-. Flag indicicating the identifier type:
+#:'P': decimal process ID
-       'P': decimal process ID
+#:'H': hexadecimal process ID
-       'H': hexadecimal process ID
+#:'N': executable program name (with or without extension) (DEFAULT)
-       'N': executable program name (with or without extension) (DEFAULT)
 ==Return Value==
-REXX RETURN VALUE:
+A string of the format:
-  A string of the format
+ pid parent-pid process-type priority cpu-time executable-name
-  pid parent-pid process-type priority cpu-time executable-name
+:"priority" is in hexadecimal notation, all other numbers are decimal.
- "priority" is in hexadecimal notation, all other numbers are decimal.
+:"" is returned if the process was not found or if an internal error occurred.
- "" is returned if the process was not found or if an internal error occurred.
 [[Category:RxUtilEx]]