Метод GetApplicationEx – получить приложение
Contents
Синтаксис:
function GetApplicationEx( const ConnectParams: WideString; out Error: Integer): OleVariant; |
Параметры:
| • | ConnectParams – параметры соединения. Передаются в формате: |
<Параметр1>=<Значение1>;<Параметр2>=<Значение2>;<ПараметрN>=<ЗначениеN>
В параметрах соединения нужно указать код системы (SystemCode) либо имя сервера и имя базы данных (ServerName и DBName). Остальные параметры являются необязательными.
UserName. Имя пользователя.
Password. Пароль пользователя.
IsOSAuth. Признак использования Windows-аутентификации. Возможные значения: True, False.
Рекомендуется вместо параметра IsOsAuth использовать параметр AuthType.
AuthType. Тип аутентификации. Возможные значения:
| • | OS – выполнить соединение с использованием Windows-аутентификации; |
| • | NOVELL – выполнить соединение с использованием Novell-аутентификации. |
IsVirtualPassword. Признак аутентификации по перекодированному паролю. Возможные значения: True, False.
Необходимо указать один из вышеперечисленных параметров в зависимости от типа аутентификации пользователя. Если тип аутентификация пользователя – «По паролю», в параметре IsVirtualPassword укажите значение False, а в параметре Password – пароль пользователя.
KeepLoginPoint. Признак необходимости хранения явной ссылки на SBLogon. Возможные значения: True, False. Если указать значение False, SBLogon выгрузится сразу после запуска приложения. Например, это удобно, когда при разработке сценария нужно выполнить операцию от имени другого пользователя или с другим кодом системы. В этом случае SBLogon загрузится снова с выполнением всех необходимых проверок. Если указать значение True, SBLogon останется загруженным. Это влияет на скорость работы: обращение к SBLogon будет происходить быстрее, так как данные получаются из кэша. Значение по умолчанию True.
InteractiveMode. Признак интерактивного режима работы (с показом форм, сообщений об ошибках и т.д.). Возможные значения: True, False. Значение по умолчанию True.
LiteMode. Получение приложения для доступа к основной информации о документе.
InstallationID. ИД инсталляции.
NovellServerName. Имя сервера Novell. Используется только при Novell-аутентификации.
PID. Идентификатор процесса. Возможные значения:
| • | -1 – объект приложения создается в новом процессе SBRte; |
| • | идентификатор запущенного процесса SBRte – объект приложения создается в процессе, идентификатор которого указан; |
| • | параметр не указан – объект приложения создается без явного указания процесса. |
Параметр PID позволяет параллельно запускать вычисления в разных процессах SBRte, вызываемых через объектную модель;
| • | Error – код сообщения об ошибке. |
Возвращаемое значение:
Приложение для указанной системы. Метод возвращает объект IApplication или ILiteApplication.
Описание:
Метод создает и возвращает объект приложения для указанной системы. Если при создании объекта приложения возникла ошибка, то код ошибки будет возвращен в параметре Error. В отличие от метода GetApplication, данный метод работает невизуально и не отображает никаких диалогов. Метод не кэширует информацию о соединениях.
Возможные значения параметра Error:
Значение параметра Error |
Описание ошибки |
|---|---|
0 |
Ошибок нет, объект приложения создан успешно |
1 |
Требуется изменение пароля, у пользователя установлен пароль по умолчанию |
17 |
Сервер не найден |
2763 |
Роль приложения не найдена |
4060 |
Невозможно открыть базу данных |
15247 |
У пользователя нет прав на выполнение данного действия |
18456 |
Не удалось произвести вход в систему |
-3 |
Неправильное имя пользователя или пароль |
-8 |
Данная система не установлена. Система установлена, если она указана в файле SystemInfo.xml |
-42 |
Неизвестная ошибка |
-43 |
Не удалось создать объект приложения |
-44 |
Ошибка установки соединения |
-45 |
Неверные параметры соединения |
-96 |
Неверные параметры разблокировки |
-97 |
Ресурс заблокирован |
Примечание
Параметр Error является выходным параметром. Его значение доступно после выполнения метода. Для его получения в параметре Error следует передавать указатель на целочисленную переменную. Метод можно вызывать только из внешних приложений.
Метод GetApplication |
| © Компания Directum, 2020 | Сообщество пользователей Directum |