pRegisterProcess
pRegisterProcess
Register a new process with the Process Manager.
Syntax
pRegisterProcess ( inout vlStatus,
in vlProcessName,
in vlWindowName,
in vlMenuName,
in vlDescription,
in vlCallback,
in vlProcessClass,
in vlParentProcessId,
out vlProcessId )
Parameters
| vlStatus | The return status from pRegisterProcess. |
| vlProcessName | A descriptive name for the process. |
| vlWindowName | The name of the window associated with the process. |
| vlMenuName | The name of the menu being used in the process. |
| vlDescription | A general description of the process. |
| vlCallback | The name of the program associated with this process. |
| vlProcessClass | A constant that identifies the class or type of process being registered. |
| vlParentProcessId | The process id of the process that is to be the parent of the calling process. |
| vlProcessId | Returned as the process id of the process. |
Comments
The pRegisterProcess command makes the Process Manager aware of a new process. The pUnregisterProcess command tells the Process Manager that a process is being terminated. The pRegisterProcess command uses pProcessManager (the REGISTER operation) to register a new process.
There are three classes of processes (identified by vlProcessClass) which have corresponding constant codes defines in $DeployServices:
| cApplicationClass(0) | Indicates a process that would be considered the main application window. It handles EXITAPPLICATION actions directly. |
| cChildClass(1) | Indicates a process that is a child of some other process (it may also be the parent of other processes). Typically, a child process passes EXITAPPLICATION actions to its parent. cChildClass processes may be the children of any other process at run time. |
| cDependentClass(2) | Is a special kind of child process that must be the child of a specific process. When they are registered, they indicate a specific parent process id in vlParentProcessId. |
If vlParentProcessId is greater than zero, the class is automatically assumed to be cDependentClass.