GALANTHUS / ABI FUNCTION REFERENCE
gln_get_balance_account_product
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_balance_account_product(const gln_balance_t* in_balance);
Purpose
Returns the account product attached to the balance when available.
Return
Returns a provider account product or display label attached to the balance row when the balance response 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_balance | input | const gln_balance_t* | nullable | borrowed |
Balance Metadata
Returns a provider account product or display label attached to the balance row when the balance response supplied one.
NULL means the materialized balance row has no account product metadata. Account identity is exposed by the dedicated identity accessors.
Notes
Passing NULL for in_balance is allowed and returns NULL.
NULL means the provider did not supply this optional field for the row.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.