GALANTHUS / ABI FUNCTION REFERENCE
gln_destroy_secret
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API void GLN_CALL gln_destroy_secret(gln_secret_t* in_secret);
Purpose
Releases a caller-owned secret handle.
Return
Returns no value.
| Type | Nullability | Ownership |
|---|---|---|
void | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_secret | input | gln_secret_t* | nonnull | borrowed |
Notes
Passing NULL for in_secret is allowed and has no effect.
Destroying a non-NULL handle destroys the contained Secure_string, which performs best-effort wiping of its live buffer and heap storage before the handle allocation is freed.
Test-transport builds may print diagnostics for non-live secret pointers. That diagnostic path is not part of the production C ABI contract.