sco_storage_v1.next_table
The first user table or view whose name sorts after “after” (NULL: from the start), in byte order, copied NUL-terminated with the size handshake; its kind goes to out_kind (SCO_STORAGE_KIND_*). The host bookkeeping table sco_kv and SQLite’s own sqlite_% objects are never listed. SCO_NOT_FOUND: no more objects; BAD_ARG: malformed after, NULL out/out_kind.
Signature
Section titled “Signature”sco_result (*)(sco_plugin *, const char *, char *, uint32_t *, uint32_t *)Service and availability
Section titled “Service and availability”| Property | Value |
|---|---|
| Symbol | sco_storage_v1.next_table |
| Record ID | sco-storage-v1-next-table |
| Service | sco.storage |
| Table | sco_storage_v1 |
| Version macro | SCO_STORAGE_VERSION_1_1 |
| Packed table version | 65537 |
| Since / availability | size >= 136; 1.1 |
| Complete member extent (x64 bytes) | 136 |
| Table size (x64 bytes) | 144 |
Parameters and buffers
Section titled “Parameters and buffers”sco_result (*next_table)(sco_plugin* self, const char* after, char* out, uint32_t* inout_size, uint32_t* out_kind);
The first user table or view whose name sorts after “after” (NULL: from the start), in byte order, copied NUL-terminated with the size handshake; its kind goes to out_kind (SCO_STORAGE_KIND_*). The host bookkeeping table sco_kv and SQLite’s own sqlite_% objects are never listed. SCO_NOT_FOUND: no more objects; BAD_ARG: malformed after, NULL out/out_kind.
Results and failures
Section titled “Results and failures”Absent table: query_service NOT_FOUND. Stopped: UNAVAILABLE; invalid/released self: BAD_ARG. Allocation exceptions: TOO_MANY; database errors may be FAILED. Additional failures/output state unspecified unless described in the buffer contract.
Absent capability
Section titled “Absent capability”Absent table: query_service NOT_FOUND.
Ownership
Section titled “Ownership”Caller buffers; inputs/SQL parameters copied during call. Host owns database/cursors; no SQLite pointer or allocation crosses the ABI.
Thread affinity
Section titled “Thread affinity”Any thread; calls serialize per plugin. Same-call recursive reentrancy unspecified.
Callback context
Section titled “Callback context”unspecified
Reentrancy
Section titled “Reentrancy”unspecified
Cleanup and cancellation
Section titled “Cleanup and cancellation”No cancellation entrypoint; ordinary unload/non-retained crash cleanup rolls back transaction and closes cursors/database. Retained-provider faults skip owner resource-release hooks and require restart; backing resources remain retained, not safe for cached calls.
Language mappings
Section titled “Language mappings”Status labels are copied verbatim from the catalogue: direct is native access; typed-wrapper is wrapper-backed; restricted is a subset/adaptation; unsupported means no supported route is established. No status implies universal safety.
| Language | Catalogue status | Source evidence / wrapper tokens |
|---|---|---|
| c | direct | include/sco_storage.h(*next_table) |
| cpp | direct | include/sco_storage.h(*next_table) |
| csharp | typed-wrapper | sdk/csharp/Sco.Sdk/Storage.csvar r = _t->next_table( |
| lua | typed-wrapper | plugins/lua/sco_lua.cconst sco_result r = st->next_table( |
Examples
Section titled “Examples”None identified in the catalogue; this is not proof none can exist.
ABI pins prove layout, not semantic behavior or a live game session.