gln_get_standing_order_submission_vop_id

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

GLN_API const char* GLN_CALL gln_get_standing_order_submission_vop_id(
    const gln_standing_order_submission_t* in_submission);

• Family: Row field accessors
• Return type: const char*

Purpose

Reads the VoP ID field from a typed standing-order 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. Standing-order writes are FinTS-only in this C API path.

Return

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

Parameters

Submission VoP

Returns the standing-order submission VoP ID when the successful FinTS result carries a VoP block.

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.

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_standing_order_submission
• ABI function index