gis_core_request_connection_state()

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

Прототип:

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

Аргументы:

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

Библиотека:

gishelper

Описание:

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

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

EOK
Соединение драйвера с источником данных находится в активном состоянии.
EINVAL
Некорректный указатель дескриптора соединения.
EAGAIN
Соединение драйвера с источником данных не установлено.
ESRCH
Запрос состояния соединения драйвера с источником данных не выполнен.
EPIPE
Соединение с картографическим ядром (сервисом) не установлено.

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

switch ( gis_core_request_connection_state( &connection, GIS_CORE_DRIVERS_SXF_LOCAL ) )
{
case EOK:
printf( "Status: driver connection state active\n" );
break;
case ESRCH:
printf( "Error: driver connection state request failed\n" );
break;
case EPIPE:
printf( "Error: not connected to GIS core\n" );
break;
default:
printf( "Status: driver connection state inactive\n" );
break;
}

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

Картографический фреймворк для ЗОСРВ "Нейтрино"

Способ использования Использование разрешено
Обработчик прерывания Нет
Обработчик сигналов Нет
В потоке Да

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

gis_core_connection_t, gis_core_driver_id_t gis_core_request_driver_connect()




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