GALANTHUS / ABI FUNCTION REFERENCE
gln_get_tan_mode_security_function
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_tan_mode_security_function(const gln_tan_mode_t* in_tan_mode);
Purpose
Returns the bank-advertised TAN security function identifier for a TAN mode row.
Return
Returns the bank-advertised security-function identifier for this TAN mode row. This is the value to pass when selecting that mode.
| 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-advertised security-function identifier for this TAN mode row. This is the value to pass when selecting that mode.
Treat the value as an open bank/provider code. For a valid row the pointer is expected to be non-null; an empty string means no security-function text was materialized.
Notes
Passing NULL for in_tan_mode is allowed and returns NULL.
The value is the FinTS TAN security function code, for example the value used when selecting a TAN mode with the backend.
The returned string is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.