GALANTHUS / ABI FUNCTION REFERENCE
gln_save_continuation
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_status_t GLN_CALL gln_save_continuation(
gln_continuation_store_t* in_store,
const char* in_id,
gln_continuation_t* in_continuation,
gln_error_t* out_error);
Purpose
Stores a continuation under caller-supplied in_id in a continuation store.
in_store, in_id, and in_continuation are borrowed for the duration of the call.
Return
Returns GLN_OK on success and a non-OK gln_status_t value on failure.
| Type | Nullability | Ownership |
|---|---|---|
gln_status_t | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_store | input | gln_continuation_store_t* | nonnull | borrowed |
in_id | input | const char* | nonnull | borrowed |
in_continuation | input | gln_continuation_t* | nonnull | borrowed |
out_error | output | gln_error_t* | nullable | caller_allocated_output |
Notes
The call copies the continuation artifact into the store; it does not transfer or destroy in_continuation.
On failure, out_error is populated when provided. Release that populated direct error slot with gln_release_error before reusing it for another call.
See Continuations and Stores for the persistence flow and store lifetime rules.