sco_api.list_commands
Writes up to max command pointers to out; returns the number of live commands. The pointers stay valid until their owning plugin unloads.
Signature
Section titled “Signature”uint32_t (*)(const sco_command **, uint32_t)Service and availability
Section titled “Service and availability”| Property | Value |
|---|---|
| Symbol | sco_api.list_commands |
| Record ID | sco-api-list-commands |
| Service | sco_api |
| Table | sco_api |
| Version macro | SCO_API_MAJOR/SCO_API_MINOR |
| Packed table version | 65537 |
| Since / availability | size >= 88; 1.0 |
| Complete member extent (x64 bytes) | 88 |
| Table size (x64 bytes) | 128 |
Parameters and buffers
Section titled “Parameters and buffers”uint32_t (*list_commands)(const sco_command** out, uint32_t max);
Writes up to max command pointers to out; returns the number of live commands. The pointers stay valid until their owning plugin unloads.
Results and failures
Section titled “Results and failures”Returns total live count, not number written; NULL out or max 0 counts only. No result/error channel or capability gate.
Absent capability
Section titled “Absent capability”unspecified
Ownership
Section titled “Ownership”out array caller-owned; command pointers host-owned until owner unload/slot reuse. Keep names, not pointers. Internal allocation unspecified.
Thread affinity
Section titled “Thread affinity”Any thread; 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 unless noted.
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_api.h(*list_commands) |
| cpp | direct | include/sco_api.h(*list_commands) |
| csharp | direct | sdk/csharp/Sco.Sdk/Interop.cspublic delegate* unmanaged[Cdecl]<ScoCommand**, uint, uint> list_commands; |
| lua | restricted | plugins/lua/sco_lua.cuint32_t n = s->api->list_commands(list, 512);plugins/lua/sco_lua.c if (n > 512) n = 512; |
Examples
Section titled “Examples”- tests/abi_v1.c
- tests/test_app.cpp
- tests/test_datacore_service.cpp
- tests/test_host.cpp
- tests/test_ipc.cpp
- tests/test_lua.cpp
- tests/test_net_service.cpp
- tests/test_plugins.cpp
- tests/test_sdk.cpp
- tests/test_settings.cpp
- tests/test_storage.cpp
- tests/test_ui.cpp
- sdk/csharp/Sco.Sdk.Tests/FakeHost.cs
- sdk/csharp/Sco.Sdk.Tests/Layout.cs
ABI pins prove layout, not semantic behavior or a live game session.