gis_core_request_driver_connect()

Запрос на установление соединения драйвера картографического ядра с источником данных (сервером).

Прототип:

#include <gis/gishelper.h>
    
int gis_core_request_driver_connect( gis_core_connection_t *connection, gis_core_driver_id_t driver_id );

Аргументы:

connection: Указатель на дескриптор соединения.
driver_id: Идентификатор драйвера.

Функция позволяет установить соединение с источником данных (сервером / хранилищем / базой данных / ...) для драйвера, определяемого идентификатором driver_id и дескриптором соединения с картографическим ядром (сервисом) connection.

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

EOK: Соединение драйвера с источником данных установлено.
EAGAIN: Соединение драйвера с источником данных не установлено.
ESRCH: Установление соединения драйвера с источником данных не выполнено.
EPIPE: Соединение с картографическим ядром не установлено.

Примеры использования:

gis_core_connection_t connection;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
if ( gis_core_request_driver_connect( &connection, GIS_CORE_DRIVERS_SXF_LOCAL ) != EOK ) {
    printf( "Status: connection not established\n" );
    return 1;
}
if ( gis_core_request_connection_state( &connection, GIS_CORE_DRIVERS_SXF_LOCAL ) != EOK )
{
    printf( "Error: driver connection state request failed\n" );
    return 1;
}
gis_core_link_destroy( &connection, true );

Классификация:

ПК ЦКИ для ЗОСРВ «Нейтрино»

Безопасность использования
Обработчик прерываний: Нет
Обработчик сигналов: Да
В потоке: Да

Тематические ссылки:

gis_core_connection_t, gis_core_driver_id_t gis_core_request_connection_state()

Предыдущий раздел: Описание API картографического фреймворка