[#OSSL_HPKE_decap]
= OSSL_HPKE_decap
:mrdocs:

Decapsulate a sender's encapsulated key and derive the shared HPKE secrets.

== Synopsis

Declared in `<openssl/hpke.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
OSSL_HPKE_decap(
    xref:OSSL_HPKE_CTX.adoc[OSSL_HPKE_CTX]* ctx,
    unsigned char const* enc,
    size_t enclen,
    xref:EVP_PKEY.adoc[EVP_PKEY]* recippriv,
    unsigned char const* info,
    size_t infolen);
----

== Return Value

1 on success, or 0 on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *ctx*
| Receiver HPKE context (only one successful call allowed per context).
| *enc*
| Encapsulated public value from OSSL_HPKE_encap().
| *enclen*
| Length of `enc` in bytes.
| *recippriv*
| Recipient private key matching the suite's KEM.
| *info*
| Optional application info bound into key schedule, or NULL if `infolen` is 0.
| *infolen*
| Length of `info` in bytes.
|===


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