GALANTHUS / ABI FUNCTION REFERENCE
gln_get_tan_mode_name
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_tan_mode_name(const gln_tan_mode_t* in_tan_mode);
Purpose
Returns the bank-advertised display name for a TAN mode row.
Return
Returns the bank-supplied display name for this TAN mode row.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_tan_mode | input | const gln_tan_mode_t* | nullable | borrowed |
TAN Mode Fields
Returns the bank-supplied display name for this TAN mode row.
Use the security-function field, not the display name, as the stable selection value. For a valid row the pointer is expected to be non-null; an empty string means no display name was materialized.
Notes
Passing NULL for in_tan_mode is allowed and returns NULL.
Use this value for labels presented to the caller. The stable selection value is the row's security function, not this display name.
The returned string is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.