sc_private_session_v1.leave

Leave only the requesting owner session; no owner is an idempotent OK. Another owner cannot leave it. No output buffer.

Signature

sco_result (*)(sco_plugin *)

Service and availability

Service index

Property	Value
Symbol	`sc_private_session_v1.leave`
Record ID	`sc-private-session-v1-leave`
Service	game.private_session
Table	sc_private_session_v1
Version macro	SC_PRIVATE_SESSION_VERSION
Packed table version	65536
Since / availability	`size >= 32`; 1.0
Complete member extent (x64 bytes)	32
Table size (x64 bytes)	40

Header source

Parameters and buffers

sco_result (*leave)(sco_plugin* self);
Leave only the requesting owner session; no owner is an idempotent OK. Another owner cannot leave it. No output buffer.

Results and failures

OK left/already idle; BAD_ARG invalid/released self; WRONG_THREAD; UNAVAILABLE foreign owner, absent broker, runtime stopping or reentrant call.

Absent capability

Disabled broker, absent admission/owner cleanup or failed registration leaves game.private_session false/unavailable. Enabled default is loopback-only and opens no socket before explicit Host/Join.

Ownership

Host owns one session and its requesting owner; request strings are borrowed for the call and copied into host storage. Plugins receive no socket/bind/allowlist authority. Caller owns copied state.

Thread affinity

Game thread only; WRONG_THREAD before state access.

Callback context

No plugin callback; offline/EAC inspection and transport are host-owned.

Reentrancy

Nested calls during broker operations are refused with UNAVAILABLE.

Cleanup and cancellation

Requesting-owner unload, explicit leave, admission loss or host stop leaves session. Stop withdraws service. Credentials are volatile backend state, not plugin-controlled persistent storage.

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_private_session.h `(*leave)`
cpp	direct	include/sc_private_session.h `(*leave)`
csharp	unsupported	docs/contracts.md `C# and Lua game.private_session routes are unsupported.`
lua	unsupported	docs/contracts.md `C# and Lua game.private_session 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.