Client Management ActiveX Control

DEVELOPER

Trail: PROIV Documentation > Developer > PROIV Developer > ActiveX > Client Management ActiveX Control

The Client Management ActiveX control can be used to create and control instances of the PROIV client application, whereby each new client session launched by the control is a full PROIV client process.

Communication

• The Client Management ActiveX control communicates with its parent PROIV client session, and also with all of the child sessions under the control's management. It sends any event notification messages received from the child sessions, to its container, via its ActiveX events.

• Communication between the Client Management ActiveX control and the child client sessions is established via the Windows COM subsystem.

Client Initialisation

Use of this control to manage child sessions can be broken down into three steps:

1. Set up the details for the next session that is to be created, by setting new values for one or more of the control's properties.

2. Call the NewSession method of the control to create the new client session, and obtain a session ID to support further operations on it.

3. Utilise other methods on the control to manage the new session. The Client Management control allows a PROIV Screen function to control position, size and state of each child session once a Session ID has been acquired via the NewSession call.

When a PROIV Screen function containing a Client Management ActiveX control is loaded, it can contain a connection to its parent session. The control can only have this connection if its own Client application was launched via a Client Management ActiveX control. In this scenario the child session PROIV Screen function can make management calls to its parent by using the value 2 for the session ID parameter.

Section links:

Client Management ActiveX Control Diagram contains a graphical overview of how the ActiveX control works.

Client Management Active Control Properties contains details of the control's properties.

Client Management ActiveX Control Events contains details of the control's events.

Client Management Active Control Methods contains details of the control's methods.

Client Management Active Control Example contains a code example which demonstrates how to open a new client session.

Comment on this topic

Topic ID: 500448