GALANTHUS / ABI FUNCTION REFERENCE
gln_get_standing_order_submission_status
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_standing_order_submission_status(
const gln_standing_order_submission_t* in_submission);
Purpose
Reads the status field from a typed standing-order submission without taking ownership of the handle.
The ABI reports a nullable return, so callers should handle NULL defensively. When passed a valid non-null handle, required fields are expected to carry a value.
This is the submission status from the successful FinTS write result. Bank acceptance is represented by the status in the success envelope.
Return
Returns the status stored on a successful standing-order submission view.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_submission | input | const gln_standing_order_submission_t* | nullable | borrowed |
Submission Status
Returns the status stored on a successful standing-order submission view.
Treat the status as an open string and compare only values the caller explicitly recognizes. The returned pointer is borrowed from the owning backend result envelope.
Notes
Passing NULL for in_submission is allowed and returns NULL.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.