Skip to content
sco-core SDK

sco_settings_v1.last_error

The message of this plugin’s last failed call (“” if none), NUL-terminated, with the size handshake.

Signature

Section titled “Signature”
sco_result (*)(sco_plugin *, char *, uint32_t *)

Service and availability

Section titled “Service and availability”

Service index

Property Value
Symbol sco_settings_v1.last_error
Record ID sco-settings-v1-last-error
Service sco.settings
Table sco_settings_v1
Version macro SCO_SETTINGS_VERSION_1_0
Packed table version 65536
Since / availability size >= 48; 1.0
Complete member extent (x64 bytes) 48
Table size (x64 bytes) 48

Header source

Parameters and buffers

Section titled “Parameters and buffers”

sco_result (*last_error)(sco_plugin* self, char* out, uint32_t* inout_size);
The message of this plugin’s last failed call (“” if none), NUL-terminated, with the size handshake.

Results and failures

Section titled “Results and failures”

BAD_ARG invalid/released self or buffer; UNAVAILABLE stopped; TOO_MANY required bytes or allocation. Empty string if no recorded failure; diagnostic completeness unspecified.

Absent capability

Section titled “Absent capability”

unspecified

Ownership

Section titled “Ownership”

Caller outputs; host owns settings; no allocation transfer. String/error copy may allocate internally.

Thread affinity

Section titled “Thread affinity”

Any thread; memory reads under lock. Recursive reentrancy unspecified.

Callback context

Section titled “Callback context”

unspecified

Reentrancy

Section titled “Reentrancy”

unspecified

Cleanup and cancellation

Section titled “Cleanup and cancellation”

No cancellation entrypoint; synchronous reads; unload withdraws settings. Retained-provider faults skip owner resource-release hooks and require restart; backing resources remain retained, not safe for cached calls.

Language mappings

Section titled “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/sco_settings.h
(*last_error)
cpp typed-wrapper include/scosdk/settings.hpp
sco_result r = t_->last_error(self_, s.data(), &size);
csharp typed-wrapper sdk/csharp/Sco.Sdk/Settings.cs
return Storage.Sized((buf, size) => _t->last_error(Self, buf, size), out byte[] b) == ScoResult.Ok ? Utf8.FromBytes(b) : “”;
lua restricted plugins/lua/sco_lua.c
st->last_error(s->self, msg, &size)
plugins/lua/sco_lua.c
static int L_settings_get(lua_State* L)

Examples

Section titled “Examples”

None identified in the catalogue; this is not proof none can exist.

Tests

Section titled “Tests”

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