gln_get_standing_order_submission_vop_alternate_name

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

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

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

Purpose

Reads the VoP alternate name 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 alternate recipient name from the standing-order submission VoP block when one is present. Returns NULL when the optional field is not materialized or when the input handle is NULL.

Parameters

Submission VoP

Returns the alternate recipient name from the standing-order submission VoP block when one is present.

NULL means the whole VoP block is absent; a non-null empty string means the VoP block is present but this field is empty.

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