[#ENGINE_get_first]
= ENGINE&lowbar;get&lowbar;first
:mrdocs:

Return the first ENGINE in OpenSSL&apos;s loaded list&period;

== Synopsis

Declared in `&lt;openssl&sol;engine&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lsqb;&lsqb;deprecated&rsqb;&rsqb;
xref:ENGINE.adoc[ENGINE]*
ENGINE&lowbar;get&lowbar;first();
----

[WARNING]
====
https://en.cppreference.com/cpp/language/attributes/deprecated[Deprecated^]. Use of this entity is allowed but discouraged.
====
== Description

Pair with ENGINE&lowbar;get&lowbar;next() to iterate&semi; release the returned reference with ENGINE&lowbar;free() when finished, unless ENGINE&lowbar;get&lowbar;next() has already released it&period;

== Return Value

Structural reference to the first ENGINE, or NULL if the list is empty&period;


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