adTempus API
ArcanaDevelopment.adTempus.Client Namespace / Scheduler Class / Connect Method / Connect(String,LoginAuthenticationType,String,String,X509Certificate2) 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.
The expected/trusted certificate for the server. See Remarks.


In This Topic
    Connect(String,LoginAuthenticationType,String,String,X509Certificate2) Method
    In This Topic
    Connects to the adTempus server on the specified machine, using the specified identity.
    Syntax

    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.
    expectedCertificate
    The expected/trusted certificate for the server. See Remarks.

    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.

    The expectedCertificate is needed when the security certificate used by the server is not trusted by the client computer (e.g., it is self-signed, or issued by an unrecognized issuing authority). In this case, calling Connect without an expectedCertificate results in a ArcanaDevelopment.adTempus.Shared.CertificateValidationException, and the exception contains the certificate returned by the server. If the client decides to accept the certificate, it can be persisted locally on the client and then passed in subsequent calls to Connect to indicate that it should be trusted.

    See Also