GALANTHUS / ABI FUNCTION REFERENCE
gln_get_holding_name
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_holding_name(const gln_holding_t* in_holding);
Purpose
Returns the provider-supplied security name.
Return
Returns the security name or display label stored on the holding row.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_holding | input | const gln_holding_t* | nullable | borrowed |
Security Identity
Returns the security name or display label stored on the holding row.
For a valid row the returned pointer is non-null. An empty string means no security name was materialized for the row.
Notes
Passing NULL for in_holding is allowed and returns NULL.
Rows returned by the matching _at accessor carry this field as part of the materialized typed result.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.