GALANTHUS / ABI FUNCTION REFERENCE
gln_take_backend_result_continuation
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_continuation_t* GLN_CALL gln_take_backend_result_continuation(gln_backend_result_t* in_result);
Purpose
Transfers the continuation handle out of an action-required backend result envelope.
After a successful take, the envelope no longer owns that continuation.
Return
Returns the caller-owned continuation handle taken from in_result; returns NULL when no continuation is available.
| Type | Nullability | Ownership |
|---|---|---|
gln_continuation_t* | nullable | transferred_out |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_result | input | gln_backend_result_t* | nullable | borrowed |
Notes
Passing NULL for in_result is allowed and returns NULL.
Pass the returned continuation to gln_resume_continuation, or save it with gln_save_continuation for later resume.
The returned continuation is caller-owned and must be released with gln_destroy_continuation. Destroying the original backend result envelope no longer destroys a continuation that has been taken.