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-операций.