Skip to content

GALANTHUS / ABI FUNCTION REFERENCE

gln_get_transfer_submission_vop_id

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

GLN_API const char* GLN_CALL gln_get_transfer_submission_vop_id(
    const gln_transfer_submission_t* in_submission);
  • Family: Row field accessors
  • Return type: const char*

Purpose

Reads the VoP ID field from a typed transfer submission without taking ownership of the handle.

The return is nullable; callers must handle NULL when the backend did not provide this optional field.

For FinTS success submissions, NULL means the whole VoP block is absent. If the VoP block is present and this field is empty, the accessor returns a non-null pointer to an empty string. EBICS transfer submissions return NULL for VoP fields.

Return

Returns the VoP ID from a FinTS transfer submission when the successful result carries a VoP block. Returns NULL when the optional field is not materialized or when the input handle is NULL.

TypeNullabilityOwnership
const char*nullableborrowed

Parameters

NameDirectionTypeNullabilityOwnership
in_submissioninputconst gln_transfer_submission_t*nullableborrowed

Submission VoP

Returns the VoP ID from a FinTS transfer submission when the successful result carries a VoP block.

NULL means the whole VoP block is absent. If the block is present and this field is empty, the accessor returns a non-null pointer to an empty string. EBICS transfer submissions return NULL for VoP fields.

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