Объекты DIRECTUM > Вспомогательные объекты > ILoginPoint – точка входа >

Метод GetApplicationEx – получить приложение

Предыдущий раздел В начало Следующий раздел

Синтаксис:

function GetApplicationEx(

 const ConnectParams: WideString;

 out Error: Integer): OleVariant;

Параметры:

ConnectParams – параметры соединения можно передавать в одном из форматов:

· «SystemCode=<код системы>[;UserName=<имя пользователя>;Password=<пароль пользователя>;IsOSAuth=<признак windows-аутентификации>;  IsVirtualPassword=<признак перекодированного пароля>]»
· «ServerName=<имя сервера>;DBName=<имя базы данных>[;UserName=<имя пользователя>;Password=<пароль пользователя>;IsOSAuth=<признак Windows-аутентификации>;IsVirtualPassword=<признак перекодированного пароля>]».

В качестве значения параметра соединения IsOSAuth следует передавать True, если нужно выполнить соединение c использованием Windows-аутентификации, иначе False.

В качестве значения параметра соединения IsVirtualPassword следует передавать True, если для пользователя указана аутентификация «По перекодированному паролю», иначе False;

Error – код сообщения об ошибке.

Возвращаемое значение:

Приложение для указанной системы. Метод возвращает объект IAplication.

Описание:

Метод создает и возвращает объект приложения для указанной системы. Если при создании объекта приложения возникла ошибка, то код ошибки будет возвращен в параметре Error. В отличие от метода GetApplication, данный метод работает не визуально и не отображает никаких диалогов. Метод не кэширует информацию о соединениях.

Возможные значения параметра Error:

Значение параметра Error

Описание ошибки

0

Ошибок нет, объект приложения создан успешно

1

Требуется изменение пароля, у пользователя установлен пароль по умолчанию

17

Сервер не найден

2763

Роль приложения не найдена

4060

Невозможно открыть базу данных

15247

У пользователя нет прав на выполнение данного действия

18456

Не удалось произвести вход в систему

-3

Неправильное имя пользователя или пароль

-8

Данная система не установлена. Система установлена, если она указана в файле SystemInfo.xml

-42

Неизвестная ошибка

-43

Не удалось установить соединение с базой данных

-44

Ошибка установки соединения

-45

Неверные параметры соединения

-96

Неверные параметры разблокировки

-97

Ресурс заблокирован

 

Примечание. Параметр Error является выходным параметром. Его значение доступно после выполнения метода. Для его получения в параметре Error следует передавать указатель на целочисленную переменную. В вычислениях ISBL для этого нужно выполнить следующие действия:

· инициализировать переменную целочисленным значением;
· в вызове метода после имени переменной указать символ «^».

См. также

Метод GetApplication