GALANTHUS / ABI FUNCTION REFERENCE
gln_get_backend_result_tan_mode_selection
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const gln_tan_mode_selection_t* GLN_CALL gln_get_backend_result_tan_mode_selection(
const gln_backend_result_t* in_result);
Purpose
Borrows the typed gln_tan_mode_selection_t view from a backend result envelope whose kind is GLN_BACKEND_RESULT_KIND_TAN_MODE_SELECTION.
The accessor returns NULL when the envelope carries a different result kind.
Return
Returns the borrowed const gln_tan_mode_selection_t* view only when gln_get_backend_result_kind reports GLN_BACKEND_RESULT_KIND_TAN_MODE_SELECTION.
| Type | Nullability | Ownership |
|---|---|---|
const gln_tan_mode_selection_t* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_result | input | const gln_backend_result_t* | nullable | borrowed |
Projection Semantics
Returns the borrowed const gln_tan_mode_selection_t* view only when gln_get_backend_result_kind reports GLN_BACKEND_RESULT_KIND_TAN_MODE_SELECTION.
The accessor checks the envelope kind directly; it does not check gln_get_backend_result_outcome or gln_get_backend_result_status. Callers should inspect outcome, status, and kind before projecting a typed success payload.
NULL means either in_result is NULL or the envelope kind does not match this projection.
The returned view is borrowed from the envelope. Destroying the envelope invalidates the view, rows or nested handles borrowed from it, and strings returned by field accessors.
Selection Semantics
The view describes the TAN mode that was selected by a successful gln_set_tan_mode call.
gln_get_tan_mode_selection_security_function returns the stored selection value. gln_get_tan_mode_selection_name returns the bank-supplied display name materialized with that selection.
Ownership And Lifetime
The returned TAN mode selection view is borrowed from the backend result envelope. Destroying the envelope invalidates the view and strings returned by its field accessors.
Notes
Passing NULL for in_result is allowed and returns NULL.
Call this after gln_set_tan_mode has produced a success envelope and gln_get_backend_result_kind reports GLN_BACKEND_RESULT_KIND_TAN_MODE_SELECTION.
The returned selection is borrowed from the envelope. Destroying the envelope invalidates the selection and strings returned by gln_get_tan_mode_selection_security_function and gln_get_tan_mode_selection_name.