sc_datacore_live_v1.read_pool

Copy bounded bytes from a host-validated scalar pool range.

Signature

sco_result (*)(sco_plugin *, uint32_t, uint64_t, void *, size_t, size_t *)

Service and availability

Service index

Property	Value
Symbol	`sc_datacore_live_v1.read_pool`
Record ID	`sc-datacore-live-v1-read-pool`
Service	game.datacore_live
Table	sc_datacore_live_v1
Version macro	SC_DATACORE_LIVE_SERVICE_VERSION_1_0
Packed table version	65536
Since / availability	`size >= 40`; 1.0
Complete member extent (x64 bytes)	40
Table size (x64 bytes)	48

Header source

Parameters and buffers

sco_result (*read_pool)(sco_plugin* self, uint32_t pool_type, uint64_t offset, void* out_buffer, size_t buffer_size, size_t* out_read);
Copy bounded bytes from a host-validated scalar pool range.

Results and failures

OK completed; BAD_ARG invalid owner, type, extent or range; WRONG_THREAD off game thread; UNAVAILABLE absent backend, admission, lifetime or write permission; NOT_FOUND missing record; FAILED backend fault.

Absent capability

No native backend is supplied. Verified callbacks, fresh offline admission and ready lifetime are required; writes additionally default OFF.

Ownership

Caller owns all buffers and output records. No engine pointer or caller buffer is retained.

Thread affinity

Game thread only; self must be live.

Callback context

No plugin callbacks; synchronous host backend calls only.

Reentrancy

Recursive backend access returns UNAVAILABLE.

Cleanup and cancellation

Stop withdraws the table and clears callbacks and write permission. Backend faults latch unavailable until process restart.

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/sc_datacore_live.h `(*read_pool)`
cpp	unsupported	docs/game/datacore-live.md `unsupported`
csharp	unsupported	docs/game/datacore-live.md `unsupported`
lua	unsupported	docs/game/datacore-live.md `unsupported`

Examples

None identified in the catalogue; this is not proof none can exist.

Tests

ABI pins prove layout, not semantic behavior or a live game session.