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.

Uses

pProcessManager