GALANTHUS / ABI FUNCTION REFERENCE
gln_get_error_detail_status_parameter_at
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_error_detail_status_parameter_at(
const gln_error_detail_t* in_detail,
size_t in_index,
size_t in_parameter_index);
Purpose
Returns one parameter string from one status row in a FinTS rejected or common rejected error detail payload.
Return
Returns the borrowed row or entry at in_index, or NULL when the handle is NULL or the index is out of range.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_detail | input | const gln_error_detail_t* | nullable | borrowed |
in_index | input | size_t | value | value |
in_parameter_index | input | size_t | value | value |
Notes
Passing NULL for in_detail is allowed and returns NULL.
The accessor returns NULL for detail kinds other than GLN_ERROR_DETAIL_FINTS_REJECTED or GLN_ERROR_DETAIL_COMMON_REJECTED, when in_index is outside gln_get_error_detail_status_count(in_detail), or when in_parameter_index is outside gln_get_error_detail_status_parameter_count(in_detail, in_index).
The returned string is borrowed from the owning detail object. Copy it before calling gln_release_error on the owning error or destroying the backend result envelope that owns that error.