CreateConnection – создать объект соединения

Синтаксис:

function CreateConnection(

[optional] SystemCode: WideString;

[optional] ConnectParams: WideString;

[optional] FormCaption: WideString): IConnection;

Параметры:

SystemCode – код системы;

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

SystemCode=<код системы>[;UserName=<имя пользователя>;Password=<пароль пользователя>;IsOSAuth=<признак windows-аутентификации>;IsVirtualPassword=<признак перекодированного пароля>]

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

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

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

FormCaption – заголовок формы параметров соединения.

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

Объект соединения.

Описание:

Функция создает соединение с указанной системой. Следует указывать либо параметр SystemCode, либо параметр ConnectParams. Если указать оба параметра, то будет сгенерировано исключение.

При указании параметра SystemCode соединение будет выполнено с именем и паролем текущего пользователя. Если в системе с кодом SystemCode такого пользователя не существует, то будет сгенерировано исключение.

При указании параметра ConnectParams соединение будет выполнено с именем, паролем и признаком Windows-аутентификации, указанными в параметре. Если один из этих параметров соединения не указан, то будет показано окно ввода имени пользователя и пароля с заголовком FormCaption.

Русскоязычный аналог имени функции:

СоздатьСоединение