GALANTHUS / ABI FUNCTION REFERENCE
gln_get_standing_order_submission_vop_result_code
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_standing_order_submission_vop_result_code(
const gln_standing_order_submission_t* in_submission);
Purpose
Reads the VoP result code field from a typed standing-order submission without taking ownership of the handle.
The return is nullable; callers must handle NULL when the backend did not provide this optional field.
For FinTS success submissions, NULL means the whole VoP block is absent. If the VoP block is present and this field is empty, the accessor returns a non-null pointer to an empty string. Standing-order writes are FinTS-only in this C API path.
Return
Returns the standing-order submission VoP result code when the successful FinTS result carries a VoP block. Returns NULL when the optional field is not materialized or when the input handle is NULL.
| 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 VoP
Returns the standing-order submission VoP result code when the successful FinTS result carries a VoP block.
Treat the result code as an open provider string. NULL means the whole VoP block is absent; a non-null empty string means the VoP block is present but this field is empty.
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.