SterBasedocs
ster.by

C ABI и C++ SDK

Все 16 функций основной C ABI-границы и типизированные менеджеры C++ SDK: сеанс, документы, справочники и результаты.

SDK предоставляет C ABI для внешней интеграции и типизированный C++ API для менеджеров данных и runtime. Версия ABI, жизненный цикл сеанса и владельцы результата должны соответствовать заголовкам используемой поставки.

Сеансовая граница

uint32_t sterbase77_sterbase_abi(void);
uint32_t sterbase77_sterbase_session_abi(void);
int32_t sterbase77_sterbase_session_open_w(
    const wchar_t* database_directory,
    const wchar_t* mode, int32_t monopoly,
    wchar_t* output, uint32_t output_size);
void sterbase77_sterbase_session_close(void);

Сигнатуры показаны без экспортных макросов. В Windows заголовок задаёт __stdcall. Открытие возвращает 0 при успехе; текущая реализация возвращает 1 для неверных аргументов, 2 для отсутствующего/неоднозначного authority, 3 при проблеме выбранного источника. Выходной буфер уточняет результат.

Общий ABI — 0x00010001, сеансовый — 0x00010000 в прочитанной реализации. Проверяйте версии при подключении согласованного пакета.

Все функции основной C ABI-границы

Декларации публичного заголовка sterbase77/sterbase.h. Макрос экспорта опущен; Windows calling convention — __stdcall. Размеры буферов, время жизни данных и callbacks определяются заголовком согласованного SDK. Внутренний C++ ABI не считается переносимым бинарным контрактом.

__declspec(dllexport) #else #define STERBASE77_STERBASE_API __declspec(dllimport) #endif #else #define #define STERBASE77_STERBASE_API #endif #ifdef __cplusplus extern "C" { #endif /* Stable POD-only boundary; no platform C++ object crosses it. */ /* Native SDK session boundary used by sterbase77_enterprise.exe. */ STERBASE77_STERBASE_API uint32_t sterbase77_sterbase_abi(void);
uint32_t sterbase77_sterbase_session_abi(void);
int32_t sterbase77_sterbase_session_open_w( const wchar_t* database_directory, const wchar_t* mode, int32_t monopoly, wchar_t* output, uint32_t output_size);
void sterbase77_sterbase_session_close(void);
int32_t sterbase77_sterbase_session_open_snapshot_w( const wchar_t* database_directory, const wchar_t* mode, int32_t monopoly, const sterbase77_sterbase_resource_view* resources, uint32_t count, wchar_t* output, uint32_t output_size);
uint32_t sterbase77_sterbase_context_mask(void);
uint32_t sterbase77_sterbase_cfb_entry_count(void);
int32_t sterbase77_sterbase_cfb_entry_w( uint32_t index, wchar_t* path, uint32_t path_capacity, uint32_t* type, uint64_t* size);
int32_t sterbase77_sterbase_cfb_entry_find_w( const wchar_t* path, uint32_t* index);
int32_t sterbase77_sterbase_cfb_entry_preview( uint32_t index, uint8_t* data, uint32_t capacity, uint32_t* size);
int32_t sterbase77_sterbase_cfb_entry_read( uint32_t index, uint64_t offset, uint8_t* data, uint32_t capacity, uint32_t* written, uint64_t* total_size);
int32_t sterbase77_sterbase_execute_module_with_context_w( uint32_t index, const wchar_t* procedure, sterbase77_module_dispatch_callback dispatch, void* caller_context, wchar_t* status, uint32_t status_capacity, int64_t* return_value, uint32_t* statements, uint32_t* line, uint32_t* column);
int32_t sterbase77_sterbase_execute_module_with_context_v2_w( uint32_t index, const wchar_t* procedure, sterbase77_module_dispatch_callback_v2 dispatch, void* caller_context, wchar_t* status, uint32_t status_capacity, int64_t* return_value, uint32_t* statements, uint32_t* line, uint32_t* column);
int32_t sterbase77_sterbase_execute_module_with_context_v3_w( uint32_t index, const wchar_t* procedure, sterbase77_module_dispatch_callback_v3 dispatch, void* caller_context, wchar_t* status, uint32_t status_capacity, int64_t* return_value, uint32_t* statements, uint32_t* line, uint32_t* column);
int32_t sterbase77_sterbase_execute_module_with_context_v4_w( uint32_t index, const wchar_t* procedure, sterbase77_module_dispatch_callback_v4 dispatch, void* caller_context, wchar_t* status, uint32_t status_capacity, int64_t* return_value, uint32_t* statements, uint32_t* line, uint32_t* column);
int32_t sterbase77_sterbase_execute_module_w( uint32_t index, const wchar_t* procedure, wchar_t* status, uint32_t status_capacity, int64_t* return_value, uint32_t* statements, uint32_t* line, uint32_t* column);

Менеджер документов

sterbase77::document::DocumentManager предоставляет:

Метод Назначение
select(request) Выборка с rows, next_cursor, has_more
get(identity) Чтение полного документа по typed reference
get_header(identity) Чтение шапки
find_by_number(...), find_by_date(...) Поиск документа
save(object) Создание или запись полного агрегата
set_delete_mark(object, marked) Пометка/снятие пометки
remove(object, physical) Пометка или физическое удаление
post(object, invocation) Проведение
unpost(object) Отмена проведения
toggle_postings(object) Изменение активности бухгалтерских проводок

Для изменений конструктор принимает фабрику ObjectMutationContext. Без неё менеджер возвращает mutation-context-unavailable.

Менеджер справочников

CatalogManager предоставляет select, find_by_code, find_by_name, find_item, get, save, set_delete_mark, remove и проверку принадлежности группе belongs_to_group. Поиск использует объявленные метаданные; физические DBF-поля не являются его контрактом.

Результаты и повторы

ObjectCommandResult содержит success, committed, reconciliation_required, revision, status, error и объектный результат. Запись может состояться, даже если последующее чтение не удалось. Такой исход нельзя превращать в слепой повтор.

В примерах показаны фрагменты интеграции. Полный каталог runtime API и схем адаптеров приведён выше; стабильность внутреннего C++ ABI не обещается.

Какой уровень использовать

Для автоматизации уже работающего Enterprise предпочтителен runtime API; для ассистента — MCP. C ABI и C++ предназначены разработчику интеграции и используют контракты SDK. Основная C ABI-граница содержит 16 функций; это не перечень всех методов C++ и не количество runtime-операций.

Поиск по SterBase

Загрузка индекса…

Индекс хранится на сайте. Поисковые запросы не отправляются внешним сервисам.