- ProcessGetID
-
- retcode
- reascode
- process_ID
- process_name
- process_name_length
Purpose
Use the ProcessGetID function to obtain the process ID of an existing process identified by
name.
Parameters
- retcode
- (output,INT,4) is a variable where the function stores the return code.
- reascode
- (output,INT,4) is a variable where the function stores the reason code.
- process_ID
- (output,INT,4) is a variable where the function returns the system-supplied identifier of the
specified process.
- process_name
- (input,CHAR,process_name_length) is a variable for specifying the name
of the process whose process ID is to be obtained.
- process_name_length
- (input,INT,4) is a variable for specifying the length of process_name.
The length must be greater than 0 and less than 16MB characters.
Usage Notes
- To obtain the process ID of the process owning the calling thread, use the ThreadGetID
function.
Return Codes and Reason Codes
| Return Code |
Reason Code |
Meaning |
| vm_pro_success |
vm_pro_success |
ProcessGetID completed successfully |
| vm_pro_error |
vm_pro_bad_name_len |
Process_name_length is out of range |
| vm_pro_error |
vm_pro_no_such_process |
No process has name process_name |
Programming Language Bindings
| Language |
Language Binding File |
| C |
VMCPRO H |
| Assembler |
VMASMPRO MACRO |
| REXX |
VMREXPRO COPY |