ADSSession class
The Connect method authenticates the client and establishes a session with the Arcana Scheduler service.
|
C++ |
hr=session->Connect(BSTR password) |
|
VB |
session.Connect(BSTR password) |
|
password |
An optional password. The password may or may not be required, depending on the security setup for the Scheduler service to which you are attempting to connect. Look for "security" in the Arcana Scheduler help index for more information on authentication. |
The following error codes are commonly encountered with this method. See the Error Codes topic for additional error-handling information.
|
ADS_PASSWORD_REQUIRED |
A password is required to connect to the Scheduler service. |
|
ADS_E_SERVICE_NOT_RUNNING |
The Arcana Scheduler service is not running. Use the StartService method to start it, then retry the connection. |
|
ADS_E_VERSION_MISMATCH |
The version of the Arcana Scheduler running on the server is different from the version being used by the client. |
|
ADS_E_INVALID_PASSWORD |
The specified password is invalid. |
To connect to the Scheduler on a remote computer you may use either of the following options:
Remote Object (DCOM). Create an instance of the ADSSession object on the target computer (using, for example, CreateObject or CoCreateInstanceEx with a remote server name) and then call the Connect method. See the COM API Architecture topic for more information.
Local Object. Create an instance of the ADSSession object on the local computer, then use the ConnectRemote method to connect to the remote server. This approach provides better performance on slow networks. See the ConnectRemote topic for more information.