[#AES_unwrap_key]
= AES_unwrap_key
:mrdocs:

Unwrap (decrypt) a key with AES Key Wrap per RFC 3394 (deprecated; prefer EVP).

== Synopsis

Declared in `<openssl/aes.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[deprecated]]
int
AES_unwrap_key(
    xref:AES_KEY.adoc[AES_KEY]* key,
    unsigned char const* iv,
    unsigned char* out,
    unsigned char const* in,
    unsigned int inlen);
----

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

Length of unwrapped data written to `out,` or a negative value on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key*
| Expanded AES key used as the Key Encryption Key.
| *iv*
| Optional 8‐byte integrity check value, or NULL for the default IV.
| *out*
| Buffer for the unwrapped key (at least `inlen` ‐ 8 bytes).
| *in*
| Wrapped key material; length must be a multiple of 8 and at least 16.
| *inlen*
| Length of `in` in bytes.
|===


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