sc_entities_v1.list_classes

Copy an epoch-pinned sorted bounded class registry page; capacity <=64, zero counts only. Stale epoch NOT_FOUND; malformed or incomplete backend snapshot refused.

Signature

sco_result (*)(uint64_t, uint32_t, sc_entity_class_page *)

Service and availability

Service index

Property	Value
Symbol	`sc_entities_v1.list_classes`
Record ID	`sc-entities-v1-list-classes`
Service	game.entities
Table	sc_entities_v1
Version macro	SC_ENTITIES_VERSION_1_2
Packed table version	65538
Since / availability	`size >= 104`; 1.2
Complete member extent (x64 bytes)	104
Table size (x64 bytes)	128

Header source

Parameters and buffers

sco_result (*list_classes)(uint64_t epoch, uint32_t offset, sc_entity_class_page* out);
Copy an epoch-pinned sorted bounded class registry page; capacity <=64, zero counts only. Stale epoch NOT_FOUND; malformed or incomplete backend snapshot refused.

Results and failures

OK copied observation; BAD_ARG invalid name/kind/output/capacity; WRONG_THREAD; NOT_FOUND stale epoch or absent item; FAILED malformed/ambiguous provider; UNAVAILABLE unbound/stopped. Known output prefix zeroed on failure, size/tail preserved.

Absent capability

game.entities.lookup OFF; no native registry/name/component adapter, not run in game.

Ownership

Caller-owned copied outputs; host session identities only, no native pointers or allocation across ABI.

Thread affinity

Game thread only.

Callback context

No plugin callbacks; synchronous bounded host backend.

Reentrancy

Recursive backend entry FAILED; stop during callback invalidates output.

Cleanup and cancellation

No retained plugin resource. Stop invalidates admission and epochs; requery session/streaming observations before use.

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_entities.h `(*list_classes)`
cpp	typed-wrapper	include/scosdk/game/entities.hpp `t_->list_classes(`
csharp	unsupported	docs/game/entities.md `1.2 tails: C# and Lua unsupported`
lua	unsupported	docs/game/entities.md `1.2 tails: C# and Lua 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.