gis_core_request_map_class_list()

Получение списка классов некоторой карты для выбранного драйвера.

Прототип:

#include <gis/gishelper.h>
    
int gis_core_request_map_class_list( gis_core_connection_t *connection, gis_core_map_information_t *map, gis_core_class_list_t *class_list );

Аргументы:

connection: Указатель на дескриптор соединения.
map_id: Идентификатор карты.
class_list: Указатель на список классов карты gis_core_class_list_t, сформированный функцией gis_core_request_map_class_list().

Функция позволяет запросить у картографического ядра список классов карты во с идентификатором map_id. При успешном выполнении запроса функция выделяет память для возвращаемого списка классов class_list самостоятельно.

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

EOK: Успешное завершение.
EPIPE: Соединение с картографическим ядром (сервисом) не установлено.
EINVAL: Один из аргументов connection или class_list указывает на NULL.
ESRCH: Получение списка классов карты не выполнено.
EFAULT: Чтение списка классов карты завершилось с ошибкой.

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

gis_core_connection_t   connection;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
gis_core_request_parameters_t map_desc;
gis_core_request_parameters_init( &map_desc );
gis_core_databuffer_attach( &connection );
gis_core_databuffer_data_request( &connection, &map_desc, 1 );
gis_core_map_list_t map_list;
gis_core_map_list_init( &map_list );
gis_core_request_maps_list( &connection, &map_desc, GIS_CORE_DRIVERS_SXF_LOCAL, &map_list );
    
gis_core_class_list_t   list;
gis_core_class_list_init( &list );
if ( gis_core_request_map_class_list( &connection, &map_list.entry_list[0], &list ) != EOK ) {
    printf( "gis_core_request_map_class_list() failed\n" );
    return 1;
}
if ( list.entry_count != 169 )
{
    printf( "Incorrect number of classes: %d\n", list.entry_count );
    return 1;
}
gis_core_map_list_free( &map_list );
gis_core_link_destroy( &connection, true );

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

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

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

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

gis_core_connection_t, gis_core_class_list_t, gis_core_driver_id_t, gis_core_class_list_free()

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