[#DH_new_by_nid]
= DH_new_by_nid
:mrdocs:

Allocate a DH object preloaded with named safe‐prime parameters.

== Synopsis

Declared in `<openssl/dh.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[deprecated]]
xref:DH.adoc[DH]*
DH_new_by_nid(int nid);
----

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

Deprecated since OpenSSL 3.0; prefer EVP_PKEY_fromdata() with a named group.

== Return Value

New DH with the named parameters set, or NULL if `nid` is unsupported or on allocation failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *nid*
| Named group NID such as NID_ffdhe2048 or NID_modp_2048.
|===


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