gis_core_request_update_cached_map()

Обновление карты в картографическом кэше.

Прототип:

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

Аргументы:

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

Функция позволяет отправить в картографическое ядро (сервис) запрос на обновление карты в картографическом кэше. Идентификатор карты map_id драйвера driver_id может быть определен с помощью функции gis_core_request_maps_list(). Для более мягкой синхронизации изменений в локальном хранилище или для повторной переконвертации всей совокупности картографической информации рекомендуется использовать функцию gis_core_request_update_cache().

Обновление карты включает:

Удаление карты в разделяемом объекте (повторную запись данная функция не осуществляет, для этого ее потребуется запросить у сервиса штатными средствами).
Удаление преобразованной во внутренний формат GCM копии данной карты.
Удаление всех хранящихся ядром сведений о карте.
Синхронизация изменений, связанных с данной картой.

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

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

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

gis_core_connection_t connection;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
if ( gis_core_request_update_cached_map( &connection, GIS_CORE_DRIVERS_SXF_LOCAL, 0 ) != EOK ) {
    printf( "Failed to update map\n" );
    return 1;
}
gis_core_link_destroy( &connection, true );

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

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

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

Считается устаревшим, начиная с ПК ЦКИ редакции 1.2

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

gis_core_connection_t, gis_core_driver_id_t, gis_core_request_maps_list(), gis_core_request_update_cache()

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