GALANTHUS / ABI FUNCTION REFERENCE
gln_load_continuation
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_status_t GLN_CALL gln_load_continuation(
gln_continuation_store_t* in_store,
const char* in_id,
gln_continuation_t** out_continuation,
gln_error_t* out_error);
Purpose
Loads the continuation stored under caller-supplied in_id from a continuation store.
On success, out_continuation receives a caller-owned continuation handle that must be released with gln_destroy_continuation.
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 |
out_continuation | output | gln_continuation_t** | nonnull | transferred_out |
out_error | output | gln_error_t* | nullable | caller_allocated_output |
Notes
The loaded continuation can be inspected with gln_inspect_continuation or gln_describe_continuation, then resumed with gln_resume_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 for the save/load/resume sequence.