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().

Библиотека:

gishelper

Описание:

Функция позволяет запросить у картографического ядра список классов карты во с идентификатором 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 картографического фреймворка