GALANTHUS / ABI FUNCTION REFERENCE
gln_get_backend_result_status
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_status_t GLN_CALL gln_get_backend_result_status(const gln_backend_result_t* in_result);
Purpose
Returns the status code stored in a backend result envelope.
Read it with gln_get_backend_result_outcome and gln_get_backend_result_kind to distinguish operation success, caller action, provider rejection, and local errors.
Return
Returns the status code stored in a backend result envelope.
| Type | Nullability | Ownership |
|---|---|---|
gln_status_t | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_result | input | const gln_backend_result_t* | nullable | borrowed |
Notes
Passing NULL for in_result is allowed and returns GLN_ERR_INVALID_ARG.
Status Semantics
GLN_OK means success only when gln_get_backend_result_outcome is GLN_BACKEND_OUTCOME_SUCCESS.
For action-required envelopes, the status names the pending action: GLN_ERR_TAN_REQUIRED, GLN_ERR_DECOUPLED_PENDING, or GLN_ERR_VOP_CONFIRMATION_REQUIRED. The result kind is GLN_BACKEND_RESULT_KIND_UNKNOWN until resume produces a success payload.
For rejected or error envelopes, inspect gln_get_backend_result_error for details. See Backend Results and Continuations.