[#OSSL_HPKE_CTX_new]
= OSSL_HPKE_CTX_new
:mrdocs:

Create an HPKE context for the given mode, suite, and sender/receiver role.

== Synopsis

Declared in `<openssl/hpke.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:OSSL_HPKE_CTX.adoc[OSSL_HPKE_CTX]*
OSSL_HPKE_CTX_new(
    int mode,
    OSSL_HPKE_SUITE suite,
    int role,
    xref:OSSL_LIB_CTX.adoc[OSSL_LIB_CTX]* libctx,
    char const* propq);
----

== Return Value

New context, or NULL on error; free with OSSL_HPKE_CTX_free().

== Parameters

[cols="1,4"]
|===
| Name| Description
| *mode*
| HPKE mode (OSSL_HPKE_MODE_BASE, PSK, AUTH, or PSKAUTH).
| *suite*
| KEM/KDF/AEAD suite identifiers.
| *role*
| OSSL_HPKE_ROLE_SENDER or OSSL_HPKE_ROLE_RECEIVER.
| *libctx*
| Library context for algorithm fetches, or NULL for the default.
| *propq*
| Optional property query string, or NULL.
|===


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