Register a new process with the Process Manager.
pRegisterProcess ( inout vlStatus,
out vlProcessId )
|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.|
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.