Initializes a new instance of the ProxyAlternateWindowsAuthSettings class given a combined domain and user name, as well as a password.

Namespace: ININ.IceLib.Connection.Extensions
Assembly: ININ.IceLib (in ININ.IceLib.dll) Version: 0.0.0.0 (22.3.0.218)

Syntax

C#
public ProxyAlternateWindowsAuthSettings(
	string targetUserName,
	ProxyTargetUserType targetUserType,
	string userNameWithDomain,
	SecureString password,
	WindowsAuthProtocols protocols
)
Visual Basic
Public Sub New ( _
	targetUserName As String, _
	targetUserType As ProxyTargetUserType, _
	userNameWithDomain As String, _
	password As SecureString, _
	protocols As WindowsAuthProtocols _
)

Parameters

targetUserName
Type: System..::..String
The target user name.
targetUserType
Type: ININ.IceLib.Connection.Extensions..::..ProxyTargetUserType
The type of user the target user.
userNameWithDomain
Type: System..::..String
The user name with the domain prefix in the form: "domain\user", or in the User Principle Name (UPN) format: "user@example.com". If no domain is specified, and the user name is not in the UPN format, the domain of the environment in which the IceLib application is running will be used.
password
Type: System.Security..::..SecureString
The user's password.
protocols
Type: ININ.IceLib.Connection..::..WindowsAuthProtocols
The Windows authentication protocols to use.

Remarks

When targetUserType is WindowsUser, targetUserName should follow the format of domain\user.

The Protocols property will be set to WindowsAuthProtocols.All.

Examples

The following example shows how to create a connection to the IC server:
CopyC#
// The IceLib Session can be created once and used for the life of the process.
Session session = new Session();
// An event handler is usually added to monitor connection state changes.
session.ConnectionStateChanged += delegate { /* React to connection state changes. */ };

// The application name can be displayed in Interaction Supervisor and is used for diagnostic operations.
SessionSettings sessionSettings = new SessionSettings();
sessionSettings.ApplicationName = "<Custom Application Name>";

// Specify the server being connected to (which is usually the IC server name).
// (It can also be a DNS "A" record that refers to both IC servers in a switchover pair.)
HostEndpoint hostEndpoint = new HostEndpoint("<IC Server Name>");
HostSettings hostSettings = new HostSettings(hostEndpoint);

// There are many options for specifying user authentication information.
// (See the derived classes of ININ.IceLib.Connection.AuthSettings for more information.)
// 
// The current windows user's windows authentication can be used (if the IC user is configured with NT credentials).
WindowsAuthSettings authSettings = new WindowsAuthSettings();
// Alternatively, IC authentication can be used.
ICAuthSettings icAuthSettings = new ICAuthSettings("<IC_User_LoginID>", "<IC_User_Password>");

// There are many options for specifying IC station information.
// (See the derived classes of ININ.IceLib.Connection.StationSettings for more information.)
// 
// If the application does not require a Station login, a simple "stationless" connection can be used.
StationlessSettings stationSettings = new StationlessSettings();
// Alternatively, an IC station could be specified.
WorkstationSettings workstationSettings = new WorkstationSettings("<IC_StationID>", SupportedMedia.Call);
// Or, a dynamic remote number station could be specified.
RemoteNumberSettings remoteNumberSettings = new RemoteNumberSettings(SupportedMedia.Call, "555-555-5555", true);

// Note: Consider using the ConnectAsync method to avoid blocking the thread.
session.Connect(sessionSettings, hostSettings, authSettings, stationSettings);

Exceptions

ExceptionCondition
System..::..ArgumentNullExceptionA parameter is nullNothingnullptra null reference (Nothing in Visual Basic).
System..::..ArgumentOutOfRangeExceptionAn invalid value was specified as part of the protocol flags.
System..::..ArgumentExceptionuserNameWithDomain is not formatted properly.

Version Information

Supported for IC Server version 2015 R1 and beyond.
For 4.0, supported for IC Server version 4.0 SU 5 and beyond.

See Also