sco_plugin_query
const sco_plugin_info* sco_plugin_query(void); info.size set to sizeof, name/version/author UTF-8 NUL strings
Signature
Section titled “Signature”const sco_plugin_info *(void)Service and availability
Section titled “Service and availability”| Property | Value |
|---|---|
| Symbol | sco_plugin_query |
| Record ID | sco-plugin-query |
| Service | native-plugin |
| Table | Native entrypoint (no table) |
| Version macro | SCO_API_MAJOR/SCO_API_MINOR |
| Packed table version | Not applicable |
| Since / availability | API 1.0; returned info must cover 32-byte sco_plugin_info |
| Complete member extent (x64 bytes) | None |
| Table size (x64 bytes) | None |
Parameters and buffers
Section titled “Parameters and buffers”const sco_plugin_info* sco_plugin_query(void); info.size set to sizeof, name/version/author UTF-8 NUL strings
Results and failures
Section titled “Results and failures”NULL info, undersized info, major mismatch, newer minor, mismatched plugin id or guarded fault refuses load; no capability gate
Absent capability
Section titled “Absent capability”unspecified
Ownership
Section titled “Ownership”Plugin-owned static info/string storage valid until DLL unload; host copies checked metadata. Never free from host
Thread affinity
Section titled “Thread affinity”Query-thread identity unspecified; 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; query does not register a cleanup notification
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.hsco_plugin_query(void) |
| cpp | typed-wrapper | include/scosdk/plugin.hppextern “C” SCO_EXPORT const sco_plugin_info* sco_plugin_query(void) |
| csharp | typed-wrapper | sdk/examples/cs_hello/CsHello.cs[UnmanagedCallersOnly(EntryPoint = “sco_plugin_query”)]sdk/examples/cs_hello/CsHello.cs PluginExports.Query( |
| lua | unsupported | sdk/docs/lua.mdA Lua plugin is a folder with |
Examples
Section titled “Examples”- tests/abi_v1.c
- tests/test_plugins.cpp
- sdk/csharp/Sco.Sdk.Tests/FakeHost.cs
- tools/test.sh
- sdk/csharp/Sco.Sdk.Tests/Layout.cs
ABI pins prove layout, not semantic behavior or a live game session.