[#OSSL_PROVIDER_try_load_ex]
= OSSL_PROVIDER_try_load_ex
:mrdocs:

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

== Synopsis

Declared in `<openssl/provider.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:OSSL_PROVIDER.adoc[OSSL_PROVIDER]*
OSSL_PROVIDER_try_load_ex(
    xref:OSSL_LIB_CTX.adoc[OSSL_LIB_CTX]* ctx,
    char const* name,
    xref:OSSL_PARAM.adoc[OSSL_PARAM]* params,
    int retain_fallbacks);
----

== Return Value

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

== Parameters

[cols="1,4"]
|===
| Name| Description
| *ctx*
| Library context that will own the provider, or NULL for the default.
| *name*
| Provider name (for example "default" or "legacy").
| *params*
| Optional OSSL_PARAM array configuring the provider, or NULL.
| *retain_fallbacks*
| Non‐zero to leave fallback providers active after a successful load.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#