TMapView.MapOpenPro

TMapView

Открыть данные, в том числе зашифрованные в формате SITX

function MapOpenPro(Value : string; mode : integer; var error: integer; password : string = ''): integer;

Описание :

Открывает карту, в том числе в формате SITX с зашифрованными данными, позволяя при этом указать пароль на раскодирование этой карты.

Параметр Value может задавать как имя файла карты, так и алиас карты на ГИС Сервере (соединение и регистрация пользователя в этом случае должны быть уже выполнены).

Параметр mode устанавливает режим доступа к файлу данных: чтение/запись (GENERIC_WRITE или 0) или только чтение (GENERIC_READ). Если параметр mode равен GENERIC_READ, то все данные открываются только на чтение; при этом не открываются файлы \Log\name.log и \Log\name.tac - протокол работы и журнал транзакций.

Если параметр mode не указан, то данные открываются для чтения/записи.

В переменную error после выполнения функции помещается код ошибки, если таковая имела место, или 0; коды ошибок приведены в maperr.rh

password - пароль доступа к данным из которого формируется 256-битный код для шифрования данных (при утрате данные не восстанавливаются).

Передача пароля необходима, если при создании карты он был указан.

Если пароль не передан, а он был указан при создании, то автоматически вызывается диалог scnGetMapPassword из mapscena.dll (gisdlgs.dll). Если выдача сообщений запрещена (mapIsMessageEnable()), то диалог/ не вызывается, а при отсутствии пароля происходит отказ открытия данных.

При успешном открытии возвращает идентификатор открытой карты (HMAP).