GALANTHUS / ABI FUNCTION REFERENCE
gln_get_transfer_submission_status
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_transfer_submission_status(
const gln_transfer_submission_t* in_submission);
Purpose
Reads the status field from a typed transfer 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 provider/result status string stored on the successful transfer submission view. Treat it as an open string rather than a fixed C enum.
Return
Returns the status string stored on the transfer submission view produced by a successful result envelope.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_submission | input | const gln_transfer_submission_t* | nullable | borrowed |
Submission Status
Returns the status string stored on the transfer submission view produced by a successful result envelope.
The value is provider/result data, not a Galanthus C enum. Compare only status strings your caller explicitly understands and do not infer final bank acceptance from this accessor alone.
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.
See Also
gln_get_backend_result_transfer_submissiongln_get_transfer_submission_idgln_get_transfer_submission_vop_idgln_get_transfer_submission_vop_result_codegln_get_transfer_submission_vop_alternate_namegln_get_transfer_submission_vop_explanatory_textgln_get_transfer_submission_provider_status_count- ABI function index