GALANTHUS / ABI FUNCTION REFERENCE
gln_destroy_state_store
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API void GLN_CALL gln_destroy_state_store(gln_state_store_t* in_store);
Purpose
Releases a caller-owned state-store handle.
Return
Returns no value.
| Type | Nullability | Ownership |
|---|---|---|
void | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_store | input | gln_state_store_t* | nonnull | borrowed |
Notes
Passing NULL for in_store is allowed and has no effect.
Destroying the handle releases the caller's handle reference. It does not call any vtable callback directly.
Backends that already retained the underlying store implementation keep using that retained implementation. Backends that keep a non-owning C handle reference require the handle to remain alive until backend close. The host-owned object referenced by the vtable's user_data must remain valid until no live handle or retained backend implementation can call it.