Assembly: ININ.IceLib (in ININ.IceLib.dll) Version: 0.0.0.0 (22.3.0.218)
Syntax
C# |
---|
public void ChangeStation( StationSettings stationSettings ) |
Visual Basic |
---|
Public Sub ChangeStation ( _ stationSettings As StationSettings _ ) |
Parameters
- stationSettings
- Type: ININ.IceLib.Connection..::..StationSettings
The StationSettings for the connection.
Remarks
For security reasons a user can only be logged in to one station at a time. If the user logs in to a different station, the system drops the original station connection. Multiple instances of client applications may be run on the same machine using different user logins and the same station.
If a user who is logged in via Interaction Client .NET Edition tries, for example, to connect using Interaction Connect, they will receive a message at the original station such as: "Your connection has been dropped due to a subsequent login on a different station".
Changing a station from StationlessSettings to any other StationSettings-derived type that uses a station is not supported. Attempting to do so will result in an IceLibException. Additionally, changing station from a StationSettings-derived type that uses a station to StationlessSettings is also not supported. Starting with 2016 R1, this will now throw an appropriate IceLibException if attempted.
Note |
---|
For more information on watches see How Watches Work. |
Exceptions
Exception | Condition |
---|---|
System..::..ArgumentNullException | A parameter is nullNothingnullptra null reference (Nothing in Visual Basic). |
ININ.IceLib.Connection..::..RequestTimeoutException | The request timed out while waiting for a response. |
ININ.IceLib.Connection..::..SessionDisconnectedException | The Session does not have a valid connection. |
System..::..ObjectDisposedException | The Session has been disposed. |
Version Information
For 4.0, supported for IC Server version 4.0 GA and beyond.
For 3.0, supported for IC Server version 3.0 GA and beyond.