[#ENGINE_set_destroy_function]
= ENGINE_set_destroy_function
:mrdocs:

Set the callback invoked when the last structural reference to an ENGINE is released.

== Synopsis

Declared in `<openssl/engine.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[deprecated]]
int
ENGINE_set_destroy_function(
    xref:ENGINE.adoc[ENGINE]* e,
    xref:ENGINE_GEN_INT_FUNC_PTR.adoc[ENGINE_GEN_INT_FUNC_PTR] destroy_f);
----

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

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *e*
| ENGINE whose destroy hook is replaced.
| *destroy_f*
| Function called to tear down `e,` or NULL to clear.
|===


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