[#EVP_EncryptInit_ex2]
= EVP_EncryptInit_ex2
:mrdocs:

Initialize a cipher context for encryption with optional OSSL_PARAM settings.

== Synopsis

Declared in `<openssl/evp.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
EVP_EncryptInit_ex2(
    xref:EVP_CIPHER_CTX.adoc[EVP_CIPHER_CTX]* ctx,
    xref:EVP_CIPHER-07.adoc[EVP_CIPHER] const* cipher,
    unsigned char const* key,
    unsigned char const* iv,
    xref:OSSL_PARAM.adoc[OSSL_PARAM] const params[]);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *ctx*
| Cipher context to initialize.
| *cipher*
| Cipher algorithm, or NULL to reuse the previous cipher.
| *key*
| Encryption key bytes, or NULL to set later.
| *iv*
| Initialization vector, or NULL when the cipher does not need one yet.
| *params*
| Optional parameter array terminated by OSSL_PARAM_END, or NULL.
|===


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