GALANTHUS / ABI FUNCTION REFERENCE
gln_get_tan_modes_selected
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_tan_modes_selected(const gln_tan_modes_t* in_tan_modes);
Purpose
Returns the stored selected TAN security function from a gln_tan_modes_t view when one is available.
Return
Returns the stored selected TAN security-function code copied into this TAN modes result when such a selection was materialized. 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_tan_modes | input | const gln_tan_modes_t* | nullable | borrowed |
Selected Mode Semantics
Returns the stored selected TAN security-function code copied into this TAN modes result when such a selection was materialized.
NULL means no selected TAN security function is stored in the materialized view. Use gln_get_tan_modes_count to inspect the mode rows independently.
A non-null value is a borrowed open bank/provider code. Compare only values the caller explicitly recognizes or previously obtained from gln_get_tan_mode_security_function.
Notes
Passing NULL for in_tan_modes is allowed and returns NULL.
For a non-null TAN modes view, NULL means the backend state does not currently carry a stored selected TAN security function. Enumerate rows separately with gln_get_tan_modes_count and gln_get_tan_mode_at.
When projecting from a backend result, first require gln_get_backend_result_tan_modes to return a non-null TAN modes view.
The returned string is borrowed from the parent envelope and becomes invalid when that envelope is destroyed.