Handing over a peer to peer collaboration session

About this task

During a peer to peer collaboration session use the Handover function to pass full control of the session to one of the other participants in the session. They become the master controller and you can leave the session without having to end it. The availability of this function during a peer to peer collaboration session is determined by the AllowHandover target property.

Set to Yes
The Hand over button appears in the collaboration control panel.
Set to No
The Hand over button does not appear in the collaboration control panel.

To pass control of a collaboration session to a new master controller complete the following steps :

Procedure

  1. Select the required controller in the participants list in the collaboration control panel.
  2. Click Hand over.
    The outcome of the handover request is determined by the value set for the ConfirmCollaboration target property.

    If this property is set to Yes for the session, the target user is asked to accept or refuse your request to handover control. If they accept the request, full session control is passed to the selected controller. If they refuse, or do not respond in a given time, a refusal message is displayed on your screen and on the selected controllers screen, and you are still the master controller of the session. Click OK

    Note: If the target user does not respond in the given time and the AcceptProceed target property is set to PROCEED, control will be passed to the new master controller.

    If ConfirmCollaboration is set to No, user acceptance is not required by the target user and full session control is passed to the new master controller.

Results

When the session is handed over to the new master controller, the collaboration control panel opens on their system. The list of participants is displayed in the collaboration control panel. You lose input control for the session. The IP address of the new master controller is displayed in the window title of your session window.

The new master controller sees the IP address of the target in the window title of their session window.