OSSL_PROVIDER_try_load_ex

Try to load a provider with parameters, optionally keeping fallback providers.

Synopsis

Declared in <openssl/provider.h>

OSSL_PROVIDER*
OSSL_PROVIDER_try_load_ex(
    OSSL_LIB_CTX* ctx,
    char const* name,
    OSSL_PARAM* params,
    int retain_fallbacks);

Return Value

Provider handle on success, or NULL on failure; unload with OSSL_PROVIDER_unload().

Parameters

NameDescription
ctxLibrary context that will own the provider, or NULL for the default.
nameProvider name (for example "default" or "legacy").
paramsOptional OSSL_PARAM array configuring the provider, or NULL.
retain_fallbacksNon-zero to leave fallback providers active after a successful load.