sc_hangar_v1.last_error
The reason for the last failed call (“” if none), NUL-terminated, with sco.storage’s size handshake: *inout_size is out’s capacity on entry and the bytes written (NUL included) on SCO_OK, or the bytes needed on SCO_TOO_MANY. out may be NULL when *inout_size is 0. On the game thread: your own last failed call; on another thread: the last refusal on that thread. Any thread.
Signature
Section titled “Signature”sco_result (*)(sco_plugin *, char *, uint32_t *)Service and availability
Section titled “Service and availability”| Property | Value |
|---|---|
| Symbol | sc_hangar_v1.last_error |
| Record ID | sc-hangar-v1-last-error |
| Service | game.hangar |
| Table | sc_hangar_v1 |
| Version macro | SC_HANGAR_SERVICE_VERSION |
| Packed table version | 65536 |
| Since / availability | size >= 40; 1.0 |
| Complete member extent (x64 bytes) | 40 |
| Table size (x64 bytes) | 40 |
Parameters and buffers
Section titled “Parameters and buffers”sco_result (*last_error)(sco_plugin* self, char* out, uint32_t* inout_size);
The reason for the last failed call (“” if none), NUL-terminated, with sco.storage’s size handshake: *inout_size is out’s capacity on entry and the bytes written (NUL included) on SCO_OK, or the bytes needed on SCO_TOO_MANY. out may be NULL when *inout_size is 0. On the game thread: your own last failed call; on another thread: the last refusal on that thread. Any thread.
Results and failures
Section titled “Results and failures”BAD_ARG invalid buffer; TOO_MANY required bytes. On the game thread with a loaded self: your own last error; otherwise the thread’s last refusal.
Absent capability
Section titled “Absent capability”unspecified
Ownership
Section titled “Ownership”Caller outputs; nothing owned, the host keeps only your last error. No allocation transfer; internal allocation unspecified.
Thread affinity
Section titled “Thread affinity”Any thread; diagnostic scope as described; recursive reentrancy unspecified.
Callback context
Section titled “Callback context”unspecified
Reentrancy
Section titled “Reentrancy”unspecified
Cleanup and cancellation
Section titled “Cleanup and cancellation”No in-flight cancellation entrypoint; a lift request or ATC cancel is one call and nothing is undone at unload; your last error is forgotten on ordinary owner release.
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/sc_hangar.h(*last_error) |
| cpp | typed-wrapper | include/scosdk/game/hangar.hppsco_result r = t_->last_error(self_, s.data(), &size); |
| csharp | typed-wrapper | sdk/csharp/Sco.Sdk/Game/Hangar.csreturn Storage.Sized((buf, size) => ((ScHangarV1*)t)->last_error((void*)self, buf, size), out byte[] b) == ScoResult.Ok |
| lua | unsupported | docs/contracts.mdLua game.hangar routes are unsupported. |
Examples
Section titled “Examples”None identified in the catalogue; this is not proof none can exist.
- tests/abi_game_hangar.c
- tests/test_hangar.cpp
- tests/test_language_routes.cpp
- tests/test_sdk.cpp
- tools/test.sh
- sdk/csharp/Sco.Sdk.Tests/GameFakeHost.cs
- sdk/csharp/Sco.Sdk.Tests/GameLayout.cs
ABI pins prove layout, not semantic behavior or a live game session.