adTempus API
ArcanaDevelopment.adTempus.Client Namespace / Scheduler Class / Connect Method / Connect(String,LoginAuthenticationType,String,SecureString) Method
The name or address of the adTempus server to connect to. Optionally include the instance name and port number, if necessary. Use BuildConnectionDescriptor to generate the connectionDescriptor in the correct syntax if the adTempus server is a named instance or is using a non-standard port. You can use BuildConnectionDescriptor to construct the descriptor in the correct format.
The type of authentication to use.
The user ID to use for authentication.
The password to use for authentication.


In This Topic
    Connect(String,LoginAuthenticationType,String,SecureString) Method
    In This Topic
    Connects to the adTempus server on the specified machine, using the specified identity.
    Syntax
    'Declaration
     
    
    <NotNullAttribute()>
    Public Overloads Shared Function Connect( _
       ByVal connectionDescriptor As String, _
       ByVal authenticationType As LoginAuthenticationType, _
       ByVal userID As String, _
       ByVal password As SecureString _
    ) As Scheduler

    Parameters

    connectionDescriptor
    The name or address of the adTempus server to connect to. Optionally include the instance name and port number, if necessary. Use BuildConnectionDescriptor to generate the connectionDescriptor in the correct syntax if the adTempus server is a named instance or is using a non-standard port. You can use BuildConnectionDescriptor to construct the descriptor in the correct format.
    authenticationType
    The type of authentication to use.
    userID
    The user ID to use for authentication.
    password
    The password to use for authentication.

    Return Value

    A Scheduler object representing a session with the adTempus server
    Exceptions
    ExceptionDescription
    Occurs if the caller does not have permission to connect to the adTempus server.

    Thrown if the adTempus service cannot be contacted. This could be because:

    • The specified server name, address, instance name, or port is invalid.
    • The adTempus service is not running on the target computer.
    • The target computer is unreachable due to a network problem.
    • A firewall or other security is blocking the connection.
    Remarks

    If authenticationType is ArcanaDevelopment.adTempus.Shared.LoginAuthenticationType.adTempus, the userID and password are required and the corresponding Security Login must be configured to use user ID/password security

    If authenticationType is ArcanaDevelopment.adTempus.Shared.LoginAuthenticationType.Windows, the Security Login must be configured to use Windows integrated security.

    • If the userID and password are specified, the connection will be made using the identity of the specified user.
    • If the userID and password are not specified, the connection will be made using the identity that the calling process is running under.
    See Also