version 2003
PA_GetProcessInfo (pNum; pName; pState; pTime)
Parameter | Type | Description | |
pNum | long | Process number | |
pName | char * | Process name | |
pState | long * | Process state | |
pTime | long * | Process state |
Description
The routine PA_GetProcessInfo returns information on the process whose number is passed in pNum.
This works exactly like the PROCESS PROPERTIES command, except for the optional 4th Dimension command argument that is not handled by the routine (visible, unique ID, origin).
The pState parameter may contain the same values as 4th Dimension constants:
Constant | Value |
Aborted | -1 |
Delayed | 1 |
Does not exist | -100 |
Executing | 0 |
Hidden modal dialog | 6 |
Paused | 5 |
Waiting for input output | 3 |
Waiting for internal flag | 4 |
Waiting for user event | 2 |
Please refer to the 4th Dimension documentation to learn more about PROCESS PROPERTIES.
Example
Count the paused processes (process state is 5).
long CountPausedProcesses() { char name[256]; long i, state, time, totCount, pausedCount; pausedCount = 0; totCount = PA_CountTotalProcess(); for(i = 1; i <= totCount; i++) { state = 0; PA_GetProcessInfo(i, name, &state, &time); if(state == 5) pausedCount++; } return pausedCount; }
See Also
PA_CountTotalProcess, PROCESS PROPERTIES.
Error Handling
Use PA_GetLastError to see if an error occurred