[#OSSL_PROVIDER_try_load]
= OSSL_PROVIDER_try_load
:mrdocs:

Try to load a provider by name, 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(
    xref:OSSL_LIB_CTX.adoc[OSSL_LIB_CTX]* libctx,
    char const* name,
    int retain_fallbacks);
----

== Return Value

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

== Parameters

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


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