sc_entities_v1.component

Copy validated ACTOR or INVENTORY component presence for a streamed entity with generation; no arbitrary payload, address or persistent component token.

Signature

sco_result (*)(uint64_t, uint32_t, sc_entity_component_record *)

Service and availability

Service index

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

Header source

Parameters and buffers

sco_result (*component)(uint64_t entity_id, uint32_t kind, sc_entity_component_record* out);
Copy validated ACTOR or INVENTORY component presence for a streamed entity with generation; no arbitrary payload, address or persistent component token.

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 `(*component)`
cpp	typed-wrapper	include/scosdk/game/entities.hpp `t_->component(`
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.