Skip to content

GALANTHUS / ABI FUNCTION REFERENCE

gln_inspect_continuation

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

GLN_API gln_status_t GLN_CALL gln_inspect_continuation(
    gln_continuation_t*      in_continuation,
    gln_continuation_info_t* out_info,
    gln_error_t*             out_error);
  • Family: Continuation functions
  • Return type: gln_status_t

Purpose

Copies structured metadata from a continuation into caller-allocated out_info storage.

Use this when the caller needs low-allocation routing fields without parsing the JSON returned by gln_describe_continuation.

Return

Returns GLN_OK on success and a non-OK gln_status_t value on failure.

TypeNullabilityOwnership
gln_status_tvaluevalue

Parameters

NameDirectionTypeNullabilityOwnership
in_continuationinputgln_continuation_t*nonnullborrowed
out_infooutputgln_continuation_info_t*nonnullcaller_allocated_output
out_erroroutputgln_error_t*nullablecaller_allocated_output

Output Fields

Initialize out_info with continuation-info output slot with struct_size set to sizeof(gln_continuation_info_t). On success, backend is GLN_CONTINUATION_BACKEND_FINTS for current client continuations.

operation_kind is a borrowed string naming the original operation. profile_hint is borrowed metadata: bank_code:user_id when both values are present, the single present value when only one is present, and NULL when neither value is present.

requires_pin is non-zero for current FinTS continuations. requires_tan is non-zero for non-decoupled FinTS continuations; use gln_describe_continuation when the caller must distinguish a TAN prompt from progress.phase == "vop_confirmation".

cached_bpd_present and cached_upd_present are non-zero when the continuation carries cached bank or user parameter data. retry_after_seconds_present is non-zero only when retry_after_seconds carries a saved decoupled polling interval; when the presence flag is zero, retry_after_seconds is 0 and must be treated as absent.

String fields written into out_info remain valid until gln_destroy_continuation destroys the continuation handle.

When To Use

Use gln_inspect_continuation for validation, routing by original operation, and quick checks before attempting gln_resume_continuation.

Use gln_describe_continuation instead for operator-facing display, diagnostics, or phase-specific UI. See Continuations.

Failure Cases

On failure, out_error is populated when provided. Release that populated direct error slot with gln_release_error before reusing it for another call.

See Also