Skip to content

GALANTHUS / ABI FUNCTION REFERENCE

gln_get_batch_transfer_submission_item_result_at

Declared in <galanthus/c_api/gln_capi.h>.

GLN_API const gln_batch_transfer_item_result_t* GLN_CALL gln_get_batch_transfer_submission_item_result_at(
    const gln_batch_transfer_submission_t* in_submission,
    size_t                                 in_index);
  • Family: Count and at accessors
  • Return type: const gln_batch_transfer_item_result_t*

Purpose

Returns the element at in_index from the batch-transfer submission. The accessor returns NULL when the index is outside the reported count.

Returned pointers are borrowed from the parent result object and must not be released directly.

Rows are FinTS item-level batch-transfer results. EBICS success submissions expose no item-result rows.

Return

Returns the borrowed row or entry at in_index, or NULL when the handle is NULL or the index is out of range.

TypeNullabilityOwnership
const gln_batch_transfer_item_result_t*nullableborrowed

Parameters

NameDirectionTypeNullabilityOwnership
in_submissioninputconst gln_batch_transfer_submission_t*nullableborrowed
in_indexinputsize_tvaluevalue

Item Result Rows

Returns a FinTS item-level batch-transfer result row by zero-based position in the materialized item-result list.

Use gln_get_batch_transfer_submission_item_results_count as the exclusive upper bound. EBICS batch-transfer success views use order/provider status and have no item-result rows, so this accessor returns NULL for every index.

Notes

Passing NULL for in_submission is allowed and returns NULL.

The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.

See Also