GALANTHUS / ABI FUNCTION REFERENCE
gln_get_batch_transfer_submission_control_sum
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_batch_transfer_submission_control_sum(
const gln_batch_transfer_submission_t* in_submission);
Purpose
Reads the control sum field from a typed batch-transfer submission without taking ownership of the handle.
The ABI reports a nullable return, so callers should handle NULL defensively. When passed a valid non-null handle, required fields are expected to carry a value.
This is the decimal control sum reported by the successful batch submission result.
Return
Returns the control-sum string reported by the successful batch-transfer submission result.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_submission | input | const gln_batch_transfer_submission_t* | nullable | borrowed |
Batch Summary
Returns the control-sum string reported by the successful batch-transfer submission result.
Read this as the submitted batch aggregate text carried by the result view. It is not an item-result count and should be interpreted together with gln_get_batch_transfer_submission_transaction_count.
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
gln_get_backend_result_batch_transfer_submissiongln_get_batch_transfer_submission_statusgln_get_batch_transfer_submission_idgln_get_batch_transfer_submission_transaction_countgln_get_batch_transfer_submission_item_results_countgln_get_batch_transfer_submission_item_result_atgln_get_batch_transfer_submission_provider_status_count- ABI function index