GALANTHUS / ABI FUNCTION REFERENCE
gln_get_tan_medium_card_number
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_tan_medium_card_number(const gln_tan_medium_t* in_medium);
Purpose
Returns the card number for a TAN medium row when the bank response supplied one.
Return
Returns the card-number field for this TAN medium row when the bank supplied one. 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_medium | input | const gln_tan_medium_t* | nullable | borrowed |
TAN Medium Fields
Returns the card-number field for this TAN medium row when the bank supplied one.
NULL means the materialized row has no card-number field. A non-null empty string means the field was materialized but had no text content.
Notes
Passing NULL for in_medium is allowed and returns NULL.
NULL means the row does not carry a card-number field. Phone-based or app-based media may legitimately omit this field.
The returned string is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.