sc_quantum_v1.hold

Refresh the owned hold lease for 1..1000 milliseconds from the latest game tick. No drive or any block refuses holding. Expiry is serviced by the next game tick.

Signature

sco_result (*)(sco_plugin *, uint32_t)

Service and availability

Service index

Property	Value
Symbol	`sc_quantum_v1.hold`
Record ID	`sc-quantum-v1-hold`
Service	game.quantum
Table	sc_quantum_v1
Version macro	SC_QUANTUM_SERVICE_VERSION
Packed table version	65536
Since / availability	`size >= 24`; 1.0
Complete member extent (x64 bytes)	24
Table size (x64 bytes)	40

Header source

Parameters and buffers

sco_result (*hold)(sco_plugin* self, uint32_t milliseconds);
Refresh the owned hold lease for 1..1000 milliseconds from the latest game tick. No drive or any block refuses holding. Expiry is serviced by the next game tick.

Results and failures

OK, BAD_ARG invalid/released self or bounds, WRONG_THREAD, UNAVAILABLE absent bridge/drive/offline admission/stopped session, NOT_FOUND non-owner hold/release, FAILED competing owner or restart-required fault.

Absent capability

Default game.quantum.control is false; mutation unavailable until a verified engine bridge exists.

Ownership

Game pack owns one bounded controller lease and hooks; output copied to caller. No allocation or engine pointer transfer.

Thread affinity

Game thread only; WRONG_THREAD before state access. No recursive calls during bridge operations.

Callback context

No plugin callback.

Reentrancy

Recursive bridge calls refused with FAILED.

Cleanup and cancellation

Release cancels hold; disable/unload clears ownership; tick expires hold or cancels on lost admission. Stop withdraws and rolls back owned hooks. Uncertain bridge cleanup retains backing state/hooks and requires 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_quantum.h `(*hold)`
cpp	direct	include/sc_quantum.h `(*hold)`
csharp	unsupported	docs/quantum.md `C# and Lua quantum routes are unsupported.`
lua	unsupported	docs/quantum.md `C# and Lua quantum routes are 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.