sc_asop_selection_v1.refresh

Read and validate the host fixed document without publishing a native selection.

Signature

sco_result (*)(sco_plugin *)

Service and availability

Service index

Property	Value
Symbol	`sc_asop_selection_v1.refresh`
Record ID	`sc-asop-selection-v1-refresh`
Service	game.asop.selection
Table	sc_asop_selection_v1
Version macro	SC_ASOP_SELECTION_VERSION
Packed table version	65536
Since / availability	`size >= 24`; 1.0
Complete member extent (x64 bytes)	24
Table size (x64 bytes)	64

Header source

Parameters and buffers

sco_result (*refresh)(sco_plugin* self);
Read and validate the host fixed document without publishing a native selection.

Results and failures

OK on success; BAD_ARG for invalid input, WRONG_THREAD, UNAVAILABLE when stopped or busy, NOT_FOUND for stale tokens, TOO_MANY for limits, FAILED for I/O. Outputs untouched on error.

Absent capability

Candidate service is unavailable until explicitly composed by the host.

Ownership

Host owns file snapshots; lease and receipts belong to the live caller. Buffers are copied.

Thread affinity

Game thread only.

Callback context

No plugin callbacks. Synchronous host adapter runs outside the service mutex.

Reentrancy

Operations refuse while a file adapter operation is active.

Cleanup and cancellation

Owner release revokes the editor and pre-commit work; a post-permit outcome remains host-owned. Stop withdraws the service.

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_asop_selection.h `(*refresh)`
cpp	typed-wrapper	include/scosdk/game/asop_selection.hpp `table_->refresh(`
csharp	unsupported	docs/game/asop-selection.md `unsupported`
lua	unsupported	docs/game/asop-selection.md `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.