GALANTHUS / ABI FUNCTION REFERENCE
gln_destroy_key_store
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API void GLN_CALL gln_destroy_key_store(gln_key_store_t* in_store);
Purpose
Releases a caller-owned EBICS key-store handle.
Return
Returns no value.
| Type | Nullability | Ownership |
|---|---|---|
void | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_store | input | gln_key_store_t* | nonnull | borrowed |
Notes
Passing NULL for in_store is allowed and has no effect.
Destroying the handle releases the caller's handle reference. It does not call free_buffer or any other vtable callback directly.
EBICS backends that already retained the underlying key-store implementation keep using that retained implementation. The host-owned object referenced by the vtable's user_data must remain valid until no live handle or retained backend implementation can call it.