sc_private_session_v1.get_state

Catalogue snapshot — development preview

SDK 2.3.0 · game pack 0.6.0 · source e616ed69d8f9f77b0f4827881c86d91e4a7d1689 Published release: sdk-v2.3.0 (immutable approved assets; this development preview is not an approved release). Source-backed inventory is not a runtime or in-game verification claim.

out.size must cover 16 bytes; copy session state, peer count and configured host max_peers (0 for joiner/idle unknown). No owner handle is required. Output size becomes 16; unknown tail untouched. Admission loss leaves the session and returns UNAVAILABLE without copying output.

Limitations / unestablished guarantees

• Portable broker/provider tests use synthetic transport and forbid sockets; not native UDP or gameplay acceptance.
• OK Host/Join is operation acceptance, not authenticated peer connection.
• No C# or Lua route.
• Fresh local UI consent is a caller obligation; startup/settings/peer replay and automatic retries must not assert it.

Signature

sco_result (*)(sc_private_session_state_v1 *)

Service and availability

Service index

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

Header source

Parameters and buffers

sco_result (*get_state)(sc_private_session_state_v1* out);
out.size must cover 16 bytes; copy session state, peer count and configured host max_peers (0 for joiner/idle unknown). No owner handle is required. Output size becomes 16; unknown tail untouched. Admission loss leaves the session and returns UNAVAILABLE without copying output.

Results and failures

OK copied state; BAD_ARG null/short output; WRONG_THREAD; UNAVAILABLE absent broker, runtime stopping, reentrant call or admission loss.

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 (*get_state)
cpp	direct	include/sc_private_session.h (*get_state)
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

• tests/abi_private_session.c
• tests/test_net_control.cpp

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